diff options
author | Jean-Pierre Giraud <jean-pierregiraud@neuf.fr> | 2022-05-30 17:52:45 +0200 |
---|---|---|
committer | Jean-Pierre Giraud <jean-pierregiraud@neuf.fr> | 2022-05-30 17:52:45 +0200 |
commit | d0cbce198528764512185fb8bf9a731923253f80 (patch) | |
tree | 719f3cee70202b6f385ec431aac39dbaefa27e0d /french/doc | |
parent | b6bfc28a547a016708242cec08e9556f91e22a43 (diff) |
(fr) doc/index.wml, vcs.wml, files updated
Diffstat (limited to 'french/doc')
-rw-r--r-- | french/doc/index.wml | 245 | ||||
-rw-r--r-- | french/doc/vcs.wml | 16 |
2 files changed, 123 insertions, 138 deletions
diff --git a/french/doc/index.wml b/french/doc/index.wml index f0ec35ae912..1a8a304a891 100644 --- a/french/doc/index.wml +++ b/french/doc/index.wml @@ -1,19 +1,37 @@ #use wml::debian::template title="Documentation" -#use wml::debian::translation-check translation="fca004f92b97a053bc89c121827943f1eae0531b" maintainer="Jean-Pierre Giraud" +#use wml::debian::recent_list +#use wml::debian::translation-check translation="cd99a152d6ce419872113e92e75e02e48fd31b94" maintainer="Jean-Pierre Giraud" # Premier traducteur: Frédéric Bothamy, 2004-2007 # Previous translator, Jean-Paul Guillonneau, 2021 -<p>La documentation est une partie importante de tout système d'exploitation -car elle englobe les manuels techniques qui décrivent le fonctionnement et -l'utilisation des programmes. Dans le cadre de la création d'un système -d'exploitation libre de haute qualité, le « Projet Debian » -s'efforce de fournir à tous ses utilisateurs une documentation facilement accessible.</p> +<link href="$(HOME)/font-awesome.css" rel="stylesheet" type="text/css"> -<h2>Démarrage rapide</h2> +<ul class="toc"> + <li><a href="#quick_start">Démarrage rapide</a></li> + <li><a href="#manuals">Manuels</a></li> + <li><a href="#other">Autres documents plus concis</a></li> +</ul> + +<p> +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. +</p> + +<h2><a id="quick_start">Démarrage rapide</a></h2> + +<p> +Si vous ne connaissez pas Debian, nous vous recommandons de +commencer par lire ces deux guides : +</p> -<p>Si vous ne connaissez pas Debian, nous vous recommandons de -commencer par lire :</p> +<aside class="light"> + <span class="fas fa-fast-forward fa-5x"></span> +</aside> <ul> <li><a href="$(HOME)/releases/stable/installmanual">le manuel d'installation</a>,</li> @@ -24,45 +42,59 @@ commencer par lire :</p> 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 :</p> +Debian. +</p> + +<p> +Par la suite, vous pouvez consulter ces documents :</p> +</p> <ul> - <li><a href="manuals/debian-handbook/">The Debian Administrator's Handbook</a>, - le manuel exhaustif de l’utilisateur ;</li> - <li><a href="manuals/debian-reference/">la référence Debian</a>, - le manuel concis pour l’utilisateur axé sur la ligne de commande ; -</li> - <li><a href="$(HOME)/releases/stable/releasenotes">les notes de - publication</a> pour les personnes effectuant une mise à jour ; -</li> - <li><a href="https://wiki.debian.org/">le wiki Debian</a>, une bonne - source d'informations pour les nouveaux arrivants.</li> + <li><a href="manuals/debian-reference/">la référence Debian</a> : le + manuel concis pour l’utilisateur axé sur la ligne de commande ;</li> + <li><a href="$(HOME)/releases/stable/releasenotes">les notes de publication</a> : + publiées à chaque mise à jour de Debian, pour les personnes effectuant une + mise à niveau de la distribution ;</li> + <li><a href="https://wiki.debian.org/">le wiki Debian </a> : le wiki officiel + de Debian, une bonne source d'informations pour les nouveaux arrivants.</li> </ul> -<p>Enfin, assurez-vous d'imprimer et d'avoir sous la main la <a -href="https://www.debian.org/doc/manuals/refcard/refcard">carte de référence -Debian GNU/Linux</a>, une liste des commandes les plus importantes pour -les systèmes Debian.</p> +<p style="text-align:center"><button type="button"><span class="fas fa-print fa-2x"></span> +<a href="https://www.debian.org/doc/manuals/refcard/refcard">Imprimez la carte de référence de Debian GNU/Linux</a></button></p> -<p>Il existe également plusieurs autres documentations listées ci-dessous.</p> +<h2><a id="manuals">Manuels</a></h2> -<h2>Types de documentation</h2> - -<p>La plupart de la documentation disponible avec Debian est issue de la +<p> +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, classés selon les catégories suivantes :</p> +documents spécifiques à Debian. En gros, ils sont classés selon les catégories +suivantes : +</p> <ul> - <li>les <a href="#manuals">manuels</a>,</li> - <li>les <a href="#howtos">HOWTO</a>,</li> - <li>les <a href="#faqs">FAQ</a>,</li> - <li>et les <a href="#other">autres documents plus courts</a>.</li> + <li>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 ;</li> + <li>les guides d'emploi : comme leurs noms l'indiquent, les + <a href="https://tldp.org/HOWTO/HOWTO-INDEX/categories.html">guides d'emploi</a> + (« HOWTO ») décrivent <em>comment faire</em> une action particulière + c'est-à-dire qu'ils offrent des conseils pratiques détaillés sur la manière + de faire quelque chose ;</li> + <li>les FAQ : nous avons rassemblé plusieurs documents répondant à des + <em>questions souvent posées</em>. Les questions spécifiques à Debian sont + traitées dans la <a href="manuals/debian-faq/">FAQ Debian</a>. Il existe + également une <a href="../CD/faq/">FAQ sur les images CD/DVD Debian</a>, + répondant à toutes sortes de questions sur les média d'installation ;</li> + <li>autres documents plus concis : consultez aussi <a href="#other">liste</a> + de modes d'emploi concis.</li> </ul> -<h3 id="manuals">Manuels</h3> - -<p>Comparables à des livres, les manuels décrivent des sujets précis de -manière très détaillée.</p> +<aside> +<p><span class="fas fa-caret-right fa-3x"></span> Pour disposer d'une liste complète des manuels Debian et des autres documentations, allez consulter la page du <a href="ddp">Debian Documentation Project</a> page. En outre, plusieurs manuels destinés à l'utilisateur, écrits pour Debian GNU/Linux, sont disponibles sous la forme d'<a href="books">ouvrages imprimés</a>.</p> +</aside> <p>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 @@ -73,23 +105,21 @@ ci-dessous par son nom de paquet ou par sa version en ligne.</p> <div class="line"> <div class="item col50"> - + <h4><a href="user-manuals">Manuels pour les utilisateurs</a></h4> <ul> <li><a href="user-manuals#faq">FAQ Debian GNU/Linux</a></li> <li><a href="user-manuals#install">Manuel d'installation Debian</a></li> <li><a href="user-manuals#relnotes">Notes de publication Debian</a></li> - <li><a href="user-manuals#debian-handbook">Manuel de l’administrateur Debian</a></li> <li><a href="user-manuals#refcard">Carte de référence Debian</a></li> - <li><a href="user-manuals#quick-reference">Guide de référence pour - Debian</a></li> + <li><a href="user-manuals#debian-handbook">Manuel de l’administrateur Debian</a></li> + <li><a href="user-manuals#quick-reference">Guide de référence pour Debian</a></li> <li><a href="user-manuals#securing">Manuel de sécurisation</a></li> <li><a href="user-manuals#aptitude">Manuel de l’utilisateur d’aptitude</a></li> <li><a href="user-manuals#apt-guide">Guide pour l’utilisateur d’APT</a></li> <li><a href="user-manuals#apt-offline">Utilisation d’APT hors ligne</a></li> <li><a href="user-manuals#java-faq">FAQ Debian GNU/Linux et Java</a></li> <li><a href="user-manuals#hamradio-maintguide">Guide pour le responsable du radioamateurisme dans Debian</a></li> - </ul> </div> @@ -108,112 +138,67 @@ ci-dessous par son nom de paquet ou par sa version en ligne.</p> <li><a href="devel-manuals#d-i-internals">À l’intérieur de l’installateur Debian</a></li> <li><a href="devel-manuals#dbconfig-common">Guide pour les responsables de paquet utilisant une base de données</a></li> <li><a href="devel-manuals#dbapp-policy">Politique pour les paquets utilisant une base de données</a></li> - </ul> - <h4><a href="misc-manuals">Manuels divers</a></h4> - <ul> - <li><a href="misc-manuals#history">Histoire du projet Debian</a></li> - </ul> - </div> - - </div> -<p class="clr">La liste complète des manuels et des documents Debian est disponible sur -les pages web du <a href="ddp">Projet de Documentation Debian</a>.</p> - -<p>Il existe également plusieurs manuels destinés aux utilisateurs et écrits -pour Debian GNU/Linux, disponibles sous la forme de <a href="books">livres -imprimés</a>.</p> - -<h3 id="howtos">Guides pratiques (HOWTO)</h3> - -<p> -Les <a href="https://tldp.org/HOWTO/HOWTO-INDEX/categories.html">guides pratiques (HOWTO)</a>, -comme leur nom l'indique en anglais, décrivent <em>comment faire</em> quelque -chose. Ils couvrent habituellement un sujet spécifique. -</p> - - -<h2 id="faqs">Foires aux questions (FAQ)</h2> - -<p>Le sigle FAQ signifie <em>foire aux questions</em>. Une FAQ est un document -qui répond aux questions les plus fréquemment posées.</p> - -<p>Les questions spécifiques à Debian sont traitées dans la <a href="manuals/debian-faq/">FAQ -Debian</a>. Il existe également une <a href="../CD/faq/">FAQ sur les -images CD/DVD Debian</a>.</p> +<p style="text-align:center"><button type="button"><span class="fas fa-book-open fa-2x"></span> <a href="misc-manuals#history">Lisez l'histoire du projet Debian</a></button></p> - -<h3 id="other">Autres documents plus concis</h3> +<h2><a id="other">Autres documents plus concis</a></h2> <p>Les documents suivants fournissent des instructions plus concises et rapidement consultables :</p> +<p> <dl> - <dt>les <strong> - <a href="https://tldp.org/docs.html#man">pages de manuel</a> - </strong></dt> - <dd> - Traditionnellement, tous les programmes Unix sont documentés par des + +<aside> +<p><span class="fas fa-caret-right fa-3x"></span> Si vous avez consulté les +ressources précédentes et que vous n'avez toujours pas trouvé de réponses à +vos questions ou de solutions à vos problèmes concernant Debian, jetez un +coup d'œil à notre<a href="../support">page dédiée à l'assistance</a>.</p> +</aside> + + <dt><strong><a href="https://tldp.org/docs.html#man">Pages de manuels</a></strong></dt> + <dd>Traditionnellement, tous les programmes Unix sont documentés par des <em>pages de manuel</em>, accessibles avec la commande <tt>man</tt>. Elles ne s'adressent habituellement pas aux - débutants. Vous pouvez trouver et lire les - pages de manuel disponibles dans Debian sur <a - href="https://manpages.debian.org/cgi-bin/man.cgi">https://manpages.debian.org/</a>. + 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 <a + href="https://manpages.debian.org/cgi-bin/man.cgi">https://manpages.debian.org/</a> </dd> - <dt><strong><a href="https://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html">fichiers info</a></strong></dt> + <dt><strong><a href="https://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html">Fichiers info</a></strong></dt> <dd>Un grand nombre de logiciels GNU sont documentés par des <em>fichiers info</em> 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, ils sont disponibles - grâce à la commande <tt>info</tt>. - </dd> - - <dt>les <strong>divers fichiers README</strong></dt> - <dd> -Les fichiers <em>README</em> (lisez-moi) sont aussi très courants. -Ce sont de simples fichiers textes décrivant un sujet unique, - d'habitude un paquet. Vous en trouverez beaucoup dans le -répertoire <tt>/usr/share/doc/</tt> du système Debian. -Dans ce répertoire, chaque paquet a son propre sous-répertoire - avec ses propres fichiers README et des exemples de configuration. Veuillez noter que, pour - les plus gros programmes, la documentation est habituellement - fournie dans un paquet séparé (avec un nom similaire au paquet - d'origine, mais se terminant par <em>-doc</em>). - </dd> - - <dt><strong>cartes de référence rapide</strong></dt> - <dd> -<p> -Les cartes de référence rapide sont des résumés très courts de -certains système ou sous-système. -Généralement, les cartes de référence -fournissent, sur une seule page, les commandes les plus utilisées. - Certaines cartes de référence peuvent être trouvées sur :</p> - <dl> - <dt><strong><a - href="https://www.debian.org/doc/manuals/refcard/refcard">carte de - référence Debian GNU/Linux</a></strong></dt> - <dd> -Cette carte est imprimable sur une seule page recto et verso. Elle - fournit une liste des commandes les plus importantes et est une bonne - référence pour les nouveaux utilisateurs de Debian voulant se - familiariser avec celles-ci. Une connaissance de base de l'ordinateur, - des fichiers, des répertoires et de la ligne de commande est requise. -Les nouveaux utilisateurs devraient lire en premier la <a - href="user-manuals#quick-reference">Référence Debian</a>.</dd> - - </dl> + ses options et des exemples d'utilisation. Les pages info + sont disponibles grâce à la commande <tt>info</tt>. </dd> -</dl> -<hrline /> + <dt><strong>Fichiers README</strong></dt> + <dd>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 <tt>/usr/share/doc/</tt> 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 <em>-doc</em>). + </dd> + + <dt><strong><a href="https://www.debian.org/doc/manuals/refcard/refcard">Cartes de référence de Debian GNU/Linux</a></strong></dt> + <dd>Les cartes de référence rapide sont des résumés très courts de + certains systèmes ou sous-systèmes et généralement listent, sur une + seule page, les commandes les plus utilisées. La carte de référence + de Debian GNU/Linux fournit la liste des commandes les plus + importantes d'un système Debian. Une connaissance de base des + fichiers, des répertoires et de la ligne de commande est requise. + Les nouveaux utilisateurs devraient lire en premier la + <a href="user-manuals#quick-reference">Référence Debian</a>. + </dd> -<p>Si vous avez consulté les ressources précédentes et que vous n'avez -toujours pas trouvé de réponses à vos questions ou de solutions à vos -problèmes concernant Debian, jetez un coup d'œil à notre <a -href="../support">page dédiée à l'assistance</a>.</p> +</dl> +</p> diff --git a/french/doc/vcs.wml b/french/doc/vcs.wml index b03fc2bbd40..595538911a8 100644 --- a/french/doc/vcs.wml +++ b/french/doc/vcs.wml @@ -101,13 +101,13 @@ git pull <p> Les privilèges de mises à jour sont accordés à tous ceux qui désirent participer -à l’écriture des manuels, des, FAQ, des guides pratiques, etc. Nous demandons +à l’écriture des manuels, des FAQ, des guides pratiques, etc. Nous demandons habituellement que vous ayez d’abord présenté quelques correctifs utiles. Après cela, suivez ces étapes pour demander l'accès en écriture : </p> <ol> - <li>Créez un compte pour <a href="https://salsa.debian.org/">Salsa</a> si ce n'est pas déjà fait ;</li> + <li>Créez un compte pour <a href="https://salsa.debian.org/">Salsa</a> si ce n'est pas déjà fait ;</li> <li>Allez sur le <a href="https://salsa.debian.org/ddp-team/">dépôt DDP</a> et cliquez sur <em>Request Access</em> ;</li> <li>Envoyez un courriel à la liste <a href="mailto:debian-doc@lists.debian.org">debian-doc@lists.debian.org</a> et dites-nous vos antécédents dans le projet Debian ;</li> <li>Une fois votre requête acceptée, vous serez membre de l'équipe DDP.</li> @@ -116,12 +116,12 @@ cela, suivez ces étapes pour demander l'accès en écriture : <h2><a id="updates">Mécanisme de mise à jour automatique</a></h2> <p> -Tous les manuels sont publiés comme des pages web. Elles sont générées -automatiquement sur www-master.debian.org dans le cadre du processus de -reconstruction régulière du site web qui se déroule toutes les quatre heures. -Pendant ce processus, la dernière version des paquets sont téléchargées de -l'archive, chaque manuel est reconstruit et tous les fichiers sont transférés -dans le sous-répertoire <code>doc/manuals/</code> du site web. +Tous les manuels sont publiés comme des pages web générées automatiquement sur +www-master.debian.org dans le cadre du processus de reconstruction régulière du +site web qui se déroule toutes les quatre heures. Pendant ce processus, la +dernière version des paquets est téléchargée de l'archive, chaque manuel est +reconstruit et tous les fichiers sont transférés dans le sous-répertoire +<code>doc/manuals/</code> du site web. </p> <p>Les fichiers de la documentation générés par le script de mise à jour sont |