<chapter id="manuel-de-l-utilisateur-du-systeme-d-aide">
<docinfo>
<date>21/10/2000</date>
<releaseinfo>1.94.00</releaseinfo>
</docinfo>
<title>
Manuel de l'utilisateur du système d'aide de KDE</title>
<anchor id="aide">

<sect1 id="aide-introduction">
<title>Système d'Aide de KDE</title>

<para>Le système d'aide de KDE est utilisé pour faciliter, d'une part, la 
lecture des outils standards d'aide du système UNIX 
(<application>man</application> et <application>info</application>), et 
d'autre part, pour visionner la documentation
propre à KDE (<abbrev>HTML</abbrev>).
</para>

<para>Toutes les applications de base sont complètement documentées grâce aux 
efforts de l'équipe de documentation. Si vous voulez aider, veuillez écrire au 
coordinateur des documentations Mike McBride à
<email>mpmcbride7@yahoo.com</email> pour tout renseignement. Il n'y a besoin
d'aucune qualification particulière, seulement de patience et d'enthousiasme. Si
vous voulez aider à traduire la documentation de KDE dans votre langue natale,
le coordinateur des traductions est &Eacute;ric Bischoff
<email>e.bischoff@noos.fr</email>, qui accueillera bien volontiers de
l'aide. Vous trouverez plus d'informations, y compris les coordinateurs pour
chaque équipe de traduction, sur <ulink url="http://i18n.kde.org">le site web
consacré à  l'internationalisation</ulink>, à la section <link
linkend="contact">Contact</link> de ce document. </para>

<sect2 id="installation">
<title>Installation</title>

<para>&khelpcenter; fait partie intégrante de l'installation de base de KDE et est
installé avec chaque copie de KDE. On peut le trouver dans le paquetage 
kdebase, disponible sur le <ulink url="ftp://ftp.kde.org/">site FTP de 
KDE</ulink> ou dans le paquetage kdebase de votre distribution Linux.</para>

</sect2>
</sect1>

<sect1 id="invoquer-l-aide">

<title>
Invoquer l'aide de KDE
</title>
<para>On peut appeler &khelpcenter; de plusieurs manières&nbsp;:</para>

<variablelist>
<varlistentry>
<term>À partir du menu <guimenu>Aide</guimenu></term>
<listitem><para>Cas le plus fréquent de l'intérieur d'une 
application.
Choisissez <menuchoice><guimenu>Aide</guimenu>
<guimenuitem>Contenu</guimenuitem></menuchoice> pour ouvrir le fichier d'aide 
de cette application à la page du contenu.</para></listitem>
</varlistentry>

<varlistentry>
<term>À partir du menu <guimenu>K</guimenu></term>
<listitem><para>Cliquez sur le gros <guiicon>K</guiicon> du tableau de bord et 
choisissez <guimenuitem>Aide</guimenuitem> pour ouvrir &khelpcenter;, à la page
d'accueil.</para></listitem>
</varlistentry>

<varlistentry>
<term>À partir du tableau de bord</term>
<listitem><para>Le  tableau de bord <application>Kicker</application> contient 
par défaut une icône pour appeler &khelpcenter;. Une nouvelle fois, c'est la
page d'accueil qui est affichée pour commencer.</para></listitem>
</varlistentry>

<varlistentry>
<term>À partir de la ligne de commande</term>
<listitem><para>&khelpcenter; peut-être activé en utilisant une <abbrev>URL</abbrev>
pour afficher un fichier. Il a aussi été ajouté les <abbrev>URL</abbrev> pour  
les pages <application>Info</application> et <application>man</application>. 
Vous pouvez les utiliser comme suit&nbsp;:</para>

<variablelist>
<varlistentry>
<term>Un fichier d'aide d'une application</term>
<listitem><para><command>khelpcenter
<option>help:/<replaceable>kedit</replaceable></option></command></para>
<para>Ouvre le fichier d'aide de <application>Kedit</application> à la page de 
début.</para></listitem>
</varlistentry>


<varlistentry>
<term>Une URL locale</term>
<listitem><para><command>khelpcenter
<option><replaceable>file:/usr/local/src/qt/html/index.html</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Une page de man</term>
<listitem><para><command>khelpcenter
<option>man:/<replaceable>strcpy</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Une page info</term>
<listitem><para><command>khelpcenter <option>info:/<replaceable>"gcc"</replaceable></option></command></para></listitem>
</varlistentry>
</variablelist>

<para>Saisir <command>khelpcenter</command> sans paramètre ouvre la page 
d'accueil par défaut.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
<!-- Interface - Basics, using Konqueror -->
<sect1 id="interface-basics">
<title>L'interface  de &khelpcenter;</title>

<para>L'interface de &khelpcenter; consiste en deux zones d'information intégrées
dans une fenêtre de &konqueror;. Ceci rend la navigation simple et intuitive, en 
utilisant les barres d'outils de &konqueror; exactement comme sur un site web. De 
plus, la plupart des documents comportent leurs propres outils de navigation, 
ce qui vous permet de vous déplacer séquentiellement dans un document en 
utilisant les liens <guilabel>Suivant</guilabel> et 
<guilabel>Précédent</guilabel> ou d'une manière moins structurée en suivant 
les hyperliens. Les liens peuvent vous emmener dans une autre partie du même 
document ou vers un autre document, et vous pouvez utiliser les icônes de la 
barre d'outils <guiicon>Précédent</guiicon> (flèche dirigée vers la gauche) et 
<guiicon>Suivant</guiicon> (flèche dirigée vers la droite) pour circuler parmi 
les documents que vous avez lus durant la session présente.</para>

<para>Les deux zones affichent le contenu du système d'aide et les fichiers 
d'aide respectivement dans la zone gauche et la zone droite.</para>

<sect2 id="contents-pane">
<title>La zone <guilabel>Contenu</guilabel></title>

<para>La zone <guilabel>Contenu</guilabel> dans &khelpcenter; est affichée dans la
partie gauche de la fenêtre. Comme vous vous en doutez, vous pouvez déplacer 
la séparation pour pouvoir lire plus confortablement le contenu d'une zone ou 
de l'autre.</para>

<para>La zone <guilabel>Contenu</guilabel> est divisée en deux onglets&nbsp;: 
l'un 
qui contient un <link linkend="contents-menu">menu</link> montrant toutes les 
informations dont &khelpcenter; dispose, et l'autre qui vous permet de <link
linkend="recherche">Chercher</link> une information spécifique.</para>

<sect3 id="contents-menu">
<title>L'onglet <guilabel>Contenu</guilabel></title>

<para>L'onglet <guilabel>Contenu</guilabel> contient les items suivants par 
défaut&nbsp;:</para>

<variablelist>
<varlistentry>
<term><guilabel>Introduction</guilabel></term>
<listitem><para>Bienvenue à KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Introduction à KDE</guilabel></term>
<listitem><para>Le guide de démarrage de KDE.  Contient une visite de 
l'interface KDE et les aides et astuces spécifiques sur la manière de mieux 
travailler avec KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Manuel d'utilisation de KDE</guilabel></term>
<listitem><para>Le manuel d'utilisation de KDE explore en profondeur KDE, y 
compris l'installation la configuration, la personnalisation et 
l'utilisation.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Manuels d'applications</guilabel></term>
<listitem><para>Les documentations des applications natives de KDE. Toutes les 
applications de KDE ont une documentation en <abbrev>HTML</abbrev>. Cette 
section fait la liste de toutes les applications de KDE avec une brève 
description et un lien vers la documentation complète de l'application.</para>
<para>Les applications sont affichées en une arborescence qui reflète la 
structure par défaut du menu <guimenu>K</guimenu>, ce qui rend facile la 
recherche de l'application dont vous avez besoin.</para></listitem> 
</varlistentry>

<varlistentry>
<term>Pages de manuel Unix</term>
<listitem><para>Les pages de man UNIX sont le format traditionnel de 
documentation pour les systèmes unix. La plupart des programmes sur votre 
système ont une page man. De plus, les pages man existent pour les fonctions 
de programmation et les formats de fichiers.</para></listitem>
</varlistentry>

<varlistentry>
<term>Naviguer dans les pages Info</term>
<listitem><para>La documentation TeXinfo est utilisée par beaucoup 
d'applications GNU, y compris <application>gcc</application> (le compilateur 
C/C++),
<application>emacs</application>, et beaucoup d'autres.</para></listitem>
</varlistentry>

<varlistentry>
<term>La FAQ de KDE</term>
<listitem><para>La Foire Aux Questions de KDE...et leurs 
réponses.</para></listitem>
</varlistentry>

<varlistentry>
<term>KDE sur le web</term>
<listitem><para>Des liens vers KDE sur le web, aussi bien le site officiel 
de KDE que d'autes sites utiles.</para></listitem>
</varlistentry>

<varlistentry>
<term>Informations sur les contacts</term>
<listitem><para>Des information sur la manière de contacter les développeurs 
de KDE et comment rejoindre les listes de diffusion de 
KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term>Participer à KDE</term>
<listitem><para>Comment aider, et comment être 
impliqué.</para></listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="recherche">
<title>L'onglet <guilabel>Chercher</guilabel></title>

<para>La recherche suppose que vous ayez l'application 
<application>ht://Dig</application> installée.  Les information concernant 
l'installation et la configuration sont disponibles dans ce document. La 
configuration de l'index de recherche est fournie dans le <application>Centre 
de configuration de KDE</application>, en choisissant le menu 
<menuchoice><guisubmenu>Aide</guisubmenu><guimenuitem>Index</guimenuitem></menuchoice>, 
et l'aide détaillée est disponible à partir de ce module.</para>

<para>Pour la lecture de ce document, nous supposons que vous avez déjà ce 
système en état de fonctionnement.</para>

<para>La recherche de fichiers d'aide est très intuitive&nbsp;: saisissez 
le(s) mot(s) que vous voulez trouver dans la zone de saisie, choisissez vos 
options (le cas échéant) et cliquez sur le bouton 
<guibutton>Chercher</guibutton>.  Le résultat s'affiche dans la zone de 
visualisation à droite.</para>

<para>Les options disponibles sont&nbsp;:</para>

<variablelist>
<varlistentry>
<term><guilabel>Méthode</guilabel></term>
<listitem><para>Choisissez comment chercher avec plusieurs mots. Si vous 
choisissez <guilabel>et</guilabel>, les resultats n'apparaîssent que si tous 
les mots de votre recherche sont présents dans la page. 
<guilabel>ou</guilabel> renvoie un résultat si <emphasis>n'importe 
lequel</emphasis> des termes est trouvé, et
<guilabel>booléen</guilabel> vous permet de chercher avec des 
combinaisonsl.</para>
<para>La syntaxe Booléenne vous permet d'utiliser les opérateurs 
<literal>AND</literal>,
<literal>OR</literal> et <literal>NOT</literal> pour faire des recherches 
complexes
Exemples&nbsp;:</para>
<variablelist>
<varlistentry>
<term><userinput>chat et chien</userinput></term>
<listitem><para>Cherche les pages qui contiennent à la fois les mots 
<userinput>chat</userinput> et <userinput>chien</userinput>.  Les pages avec 
un seul des deux mots n'apparaîssent pas.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>chat not chien</userinput></term>
<listitem><para>Cherche les pages qui contiennent <userinput>cat</userinput>, 
mais n'affichent que celles qui ne contiennent pas le mot 
<userinput>dog</userinput>.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>chat or (chien not nez)</userinput></term>
<listitem><para>Cherche les pages qui contiennent  
<userinput>chat</userinput>, et les pages qui contiennent 
<userinput>chien</userinput> mais sans contenir <userinput>nez</userinput>. 
Les pages qui contiennent à la fois <userinput>chat</userinput> et 
<userinput>nez</userinput> seront affichées, mais pas celles qui contiennent 
les trois mots.</para></listitem> 
</varlistentry>
</variablelist>
<para>Si vos recherches ne renvoient pas le résultat escompté, vérifiez que 
vous n'avez pas exclu le mauvais terme avec <literal>NOT</literal> ou une 
parenthèse mal placée.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Nombre maximum de résultats</guilabel></term>
<listitem><para>Détermine le nombre maximum de résultats qu'affichera la 
recherche.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Format</guilabel></term>
<listitem><para>Décide si vous voulez simplement un court lien vers la page 
qui contient votre terme recherché ou si vous voulez un sommaire plus 
long.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Trier</guilabel></term>
<listitem><para>Trie les résultats de la recherche dans l'ordre 
<guilabel>Score</guilabel> (correspondance entre ce qui est cherché et ce qui 
est trouvé), alphabétiquement par <guilabel>Titre</guilabel> ou par 
<guilabel>Date</guilabel>.  En cochant la case <guilabel>Ordre 
inverse</guilabel> les résultats de la recherche sont 
inversés.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Actualiser l'index</guilabel></term>
<listitem><para>Met à jour l'index de recherche, pour incorporer de nouveaux 
documents ou si vous pensez que la base de données est incomplète ou 
endommagée. Ceci peut prendre du temps.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

<sect2 id="man-et-info">
<title>La section <application>Man</application> et 
<application>Info</application>
</title>

<para>Les pages man sont les pages de manuel standard d'unix, et sont
utilisées depuis des années sur beaucoup de systèmes d'exploitation. Elles 
sont très détaillées et sont le meilleur endroit pour obtenir de l'information 
sur la plupart des commandes et applications Linux . Quand on vous dit 
<quote>RTFM</quote>, le manuel dont il est question est très souvent la page 
de man.</para>

<para>Cependant, les pages man ne sont pas parfaites. Elles tentent d'être 
complète, mais également très techniques, souvent écrites par des développeurs 
et pour des développeurs. Dans certains cas, ceci les rend quelque peu 
inamicales, voire totalement incompréhensibles pour beaucoup d'utilisateurs. 
Elles sont malgré tout la meilleure source d'information solide sur la plupart 
des applications en lignes de commande, et très souvent la seule source.</para>

<para>Si vous vous êtes jamais demandé ce que le chiffre veut dire dans 
man(1), cela signifie  dans quelle section du manuel l'item se trouve. Vous 
verrez que &khelpcenter; utilise les chiffres pour diviser la plupart des pages de
man dans leur propres sections, vous rendant plus facile la recherche de 
l'information que vous recherchez si vous naviguez simplement.</para>

<para>Également disponibles, les pages Info, qui tentent de remplacer les 
pages man. Les responsables de certaines pages man ne les maintiennent plus. 
Ainsi, s'il existe à la fois une page man et une page info, il est 
vraisemblable que la page info est plus récente. La plupart des applications 
ont l'une ou l'autre. Si l'applications que vous cherchez est un utilitaire 
<abbrev>GNU</abbrev>, vous trouverez vraisemblablement une page info, pas 
man.</para>

<sect3 id="navigation">
<title>Navigation dans les pages <application>Info</application></title>

<para> Les documents Info sont structurés hiérarchiquement, chaque page 
s'appelant un noeud. Tous les documents info ont un noeud <guilabel>Top 
niveau</guilabel>, par exemple la page d'accueil. Vous pouvez retourner à la 
page <guilabel>Top niveau</guilabel> d'un document info en cliquant sur 
<guilabel>Top</guilabel>.</para>

<para>On utilise <guibutton>Précédent</guibutton> et 
<guibutton>Suivant</guibutton> pour se déplacer vers les pages précédentes et 
suivantes par rapport au niveau de la hiérarchie où vous vous situez.</para>

<para>Cliquer sur un item de menu à l'intérieur d'un document vous déplace 
vers un niveau inférieur dans la hiérarchie. Vous pouvez remonter dans la 
hiérarchie en cliquant sur <guibutton>Dossier parent</guibutton>.</para>

<para>Man est traité de la même manière qu'info, avec l'index de section 
équivalant au noeud top niveau, et chaque page de man au niveau au dessous. 
Les pages de man s'étalent sur une seule page.</para>

</sect3>
</sect2>
</sect1>

<sect1 id="credits">
<title>Remerciements et Licences</title>

<para>&khelpcenter;</para>

<para>Originellement développé par Matthias Elter 
<email>me@kde.org</email></para>
<para>Maintaineur actuel Matthias Hoelzer-Kluepfel
<email>mhk@kde.org</email></para>
<para>Traduction française Gérard DELAFOND
<email>g.delafond@medsyn.fr</email></para>

&underFDL;
&underGPL;

</sect1>
</chapter>
