<abstract><para>&kdict; est un client graphique pour le protocole <productname>DICT</productname> permettant d'explorer des bases de données dictionnaires pour chercher un mot ou une phrase, puis d'afficher les définitions appropriées.</para></abstract>
<para>&kdict; est un client graphique pour le protocole <systemitem>DICT permettant d'</systemitem>explorer des bases de données dictionnaires pour chercher un mot ou une phrase, puis d'afficher les définitions appropriées. &kdict; tente de faciliter la recherche de base aussi bien que la recherche avancée. Une liste séparée offre un moyen pratique de traiter l'énorme nombre de mots correspondants qu'une recherche avancée peut renvoyer. </para>
<para>Le reste de l'interface utilisateur de &kdict; ressemble à un navigateur web. Par exemple, vous pouvez passer à la définition d'un synonyme d'un simple clic sur le mot mis en surbrillance. La fonctionnalité Précédent/Suivant est également mise en œuvre, ce qui vous permet de revenir rapidement au résultat des requêtes précédentes. </para>
<para>Comme &kdict; est capable de traiter le contenu du presse-papiers, il est facile de combiner &kdict; avec votre navigateur web ou votre éditeur de texte.</para>
<para>Lorsque votre machine est derrière un pare-feu, qu'elle a une connexion internet non permanente ou que le serveur de dict.org est trop lent pour vous, vous pouvez installer votre propre serveur local: tout ce dont vous avez besoin est disponible à l'adresse <ulink url="http://www.dict.org">www.dict.org</ulink>. Parmi les avantages d'un serveur local, citons une performance optimale et la capacité d'installer les bases de données additionnelles de votre choix. Ce guide contient un <link linkend="dictd-mini-howto">petit didacticiel d'installation et des liens vers quelques bases de données.</link></para>
<para>Après avoir démarré &kdict; (à l'aide du menu du tableau de bord ou en saisissant <command>kdict</command> à l'invite de commande), la fenêtre principale de &kdict; apparaît:</para>
<para>Il ya deux méthodes différentes pour chercher un mot ou une phrase avec &kdict;. Avec une <link linkend="define-query">requête Définir</link>, &kdict; cherche les correspondances exactes dans les bases de données et affiche toutes les définitions correspondantes dans la partie inférieure gauche. Ou bien faites appel à une <link linkend="match-query">requête Correspondance</link>: dans ce cas, tous les éléments correspondants de la base de données sont affichés en mode liste sur le côté droit. Vous pouvez alors décider quelles définitions vous souhaitez examiner. Cette méthode a l'avantage de pouvoir utiliser davantage de stratégies sophistiquées de recherche comme un préfixe, un suffixe ou des expressions rationnelles.</para>
<title>Configuration du serveur <systemitem>DICT</systemitem></title>
<para>Avant de pouvoir procéder à votre première requête, vérifiez si les réglages prédéfinis du serveur fonctionnent avec votre configuration. Vous pouvez modifier les réglages dans la <link linkend="preferences">boîte de dialogue Préférences</link>. Le serveur prédéfini est dict.org: comme il s'agit d'un serveur public, ne changez rien si vous avez une connexion internet opérationnelle.</para>
<para>Testez votre configuration en choisissant <guimenuitem>Informations sur le serveur</guimenuitem> dans le menu <guimenu>Serveur</guimenu>. Quelques informations sur l'état du serveur y sont affichées.</para>
<para>Utilisez à présent <menuchoice><guimenu>Serveur</guimenu><guimenuitem>Interroger les capacités</guimenuitem></menuchoice>: pour extraire une liste des bases de données et des stratégies disponibles depuis le serveur. &kdict; est maintenant en mesure d'afficher toutes les fonctionnalités du serveur dans ses menus. (Appelez toujours <guimenuitem>Interroger les capacités</guimenuitem> après avoir basculé vers un nouveau serveur) </para>
<para>Une requête Définir cherche des mots ou des phrases dans la(les) base(s) de données sélectionnée(s), qui correspondent exactement au texte donné. Les définitions appartenant à ces mots sont affichées dans la fenêtre principale. Si le serveur ne trouve rien qui convient, &kdict; emploie une stratégie de recherche optimisée de vérification orthographique pour afficher une liste de mots similaires.</para>
<para>Dans la plupart des bases de données, certains mots (en particulier, les synonymes) sont signalés entre parenthèses (<quote>{}</quote>). Ces mots sont mis en surbrillance, et un clic dessus avec le &BGS; démarre une nouvelle requête Définir sur ce mot.</para>
<para>Vous pouvez sélectionner une partie du texte avec le &BGS;. La sélection est automatiquement copiée dans le presse-papiers: cette fonction est très commode car elle permet d'utiliser le &BCS; à n'importe quel endroit de la fenêtre principale pour définir le contenu du presse-papiers. Ainsi, si vous souhaitez obtenir une définition d'un mot ou d'une phrase qui n'est pas identifiée comme synonyme, mettez-le(la) simplement en évidence avec le &BGS;, et vous obtenez la définition en cliquant avec le &BCS;.</para>
<para>Le &BDS; affiche un menu contextuel dans lequel vous pouvez choisir de démarrer des requêtes avec le texte sélectionné, le presse-papiers ou le synonyme identifié sous le pointeur de la souris. Le menu comporte aussi deux éléments <guimenuitem>Précédent</guimenuitem> et <guimenuitem>Suivant</guimenuitem>. Utilisez-les pour explorer les résultats des requêtes précédentes.</para>
<para>Une requête Correspondance utilise la stratégie de recherche actuellement sélectionnée (le sélecteur de stratégies est situé au-dessus de la liste des correspondances) pour chercher dans la(les) base(s) de données sélectionnée(s) des mots similaires au texte donné. Le résultat est une liste de mots similaires qui apparaîr dans la liste des correspondances, en fonction de la base de données à laquelle ils appartiennent. Vous avez à présent de multiples options:</para>
<para>Utilisez le bouton <guibutton>Tout réceptionner</guibutton> (situé au-dessous de la liste des correspondances) pour extraire toutes les définitions. Notez que le nombre de mots répertoriés et de définitions extraites peut varier car, dans certains cas, deux ou plusieurs mots partagent une définition et &kdict; supprime les définitions en double.</para>
<para>À l'aide de la souris ou du clavier, choisissez les mots les plus intéressants dans la liste puis cliquez sur le bouton <guibutton>Réceptionner la sélection</guibutton> (situé au-dessous de la liste des correspondances) pour n'extraire que ces dernières. Pour obtenir toutes les définitions depuis une base de données, choisissez simplement l'élément de liste qui contient le nom de la base de données.</para>
<para>En appuyant sur <keycap>Entrée</keycap> (au clavier) ou en double-cliquant (à la souris) sur un élément de liste, &kdict; ignore la sélection et extrait la définition de cet élément. Si vous le faites avec un élément <quote>racine</quote> (un élément contenant le nom de la base de données, vous obtenez toutes les définitions qui appartiennent à cette base de données.</para>
<para>Un clic avec le &BCS; à un endroit quelconque de la liste démarre une nouvelle requête de correspondance avec le contenu du presse-papiers (similaire à la fenêtre principale).</para>
<term><guimenuitem>Correspondance avec le contenu du presse-papiers</guimenuitem>, <guimenuitem>Définir le contenu du presse-papiers</guimenuitem> </term>
<listitem><para>Démarre une requête Correspondance/Définir avec le contenu actuel du presse-papiers.</para>
<para>Il est parfois utile de restreindre une requête à un sous-ensemble des bases de données disponibles, par exemple: tous les dictionnaires anglais-allemand. Pour ce faire, on définit des <quote>ensembles de bases de données</quote> qui apparaissent dans le sélecteur de bases de données sous forme de bases de données virtuelles.</para>
<para>Vous pouvez accéder à cette boîte de dialogue de configuration via <menuchoice><guimenu>Serveur</guimenu><guimenuitem>Modifier les ensembles de bases de données...</guimenuitem></menuchoice> ou l'icône située sur la barre d'outils.</para>
<listitem><para>Utilisez ce sélecteur pour choisir l'ensemble que vous souhaitez modifier. Vous pouvez également renommer un ensemble ici en saisissant un nouveau nom et en cliquant sur le bouton <guibutton>Enregistrer</guibutton>.</para></listitem>
<listitem><para>Enregistre les modifications que vous avez effectuées dans l'ensemble actuel. Utilisez ce bouton avant de choisir un autre ensemble ou quittez la boîte de dialogue, sinon toutes les modifications seront perdues.</para></listitem>
<para>Les deux listes (<guilabel>Bases de données sélectionnées</guilabel> et <guilabel>Bases de données disponibles</guilabel>) montrent quelles bases de données se trouvent actuellement dans l'ensemble de bases de données. Utilisez les boutons fléchés entre les listes pour transférer des éléments d'une liste à l'autre.</para>
<para>Signalons que vous pouvez laisser cette boîte de dialogue de configuration ouverte et poursuivre votre travail avec &kdict;. C'est un bon moyen de tester immédiatement vos changements.</para>
<para>Vous pouvez modifier de nombreux aspects du comportement de &kdict; dans la boîte de dialogue Préférences. Celle-ci peut s'ouvrir via <menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configurer Kdict...</guimenuitem></menuchoice> ou l'icône située sur la barre d'outils.</para>
<para>La boîte de dialogue est divisée en plusieurs pages. Le bouton <guibutton>Par défaut</guibutton> restaure les valeurs par défaut de la page actuelle. Le bouton <guibutton>Appliquer</guibutton> applique vos modifications sur toutes les pages. Le bouton <guibutton>OK</guibutton> applique les changements et ferme la boîte de dialogue. Le bouton <guibutton>Annuler</guibutton> fait de même sans enregistrer les modifications. Signalons que vous pouvez laisser la boîte de dialogue Préférences ouverte et poursuivre votre travail avec &kdict;. C'est un bon moyen de tester vos modifications.</para>
<term><guilabel>Maintenir la connexion pour</guilabel></term>
<listitem><para>&kdict; est capable de maintenir la connexion ouverte pendant de courtes périodes d'inactivité. Cette fonctionnalité évite la longue procédure de connexion avant chaque requête. Une valeur de 0seconde désactive cette fonctionnalité. Des valeurs très élevées n'ont aucune utilité car, dans la plupart des cas, le serveur <productname>DICT</productname> fermera la connexion au bout de deux minutes.</para></listitem>
<term><guilabel>Tampon de commande</guilabel></term>
<listitem><para>Le protocole <productname>DICT</productname> permet au client d'envoyer des commandes multiples dans un seul paquet de réseau. La taille du tampon interne de commande détermine combien de commandes &kdict; émet en parallèle. Essayez d'affiner cette valeur pour votre connexion réseau mais le plus souvent, cela n'en vaut pas la peine.</para></listitem>
<listitem><para>Ce sélecteur permet de spécifier la méthode d'encodage du texte des bases de données. La valeur par défaut est «utf8»: ce paramètre devrait fonctionner sur la plupart des serveurs. Si un encodage est sélectionné et ne correspond pas à l'encodage qu'utilisent les bases de données, vous verrez des caractères tronqués.</para></listitem>
<term><guilabel>Le serveur exige une identification</guilabel></term>
<listitem><para>Cochez cette case si vous souhaitez fournir une authentification avec un nom d'utilisateur et un mot de passe. (un serveur peut l'exiger pour accéder à toutes les bases de données) Saisissez au-dessous une combinaison <guilabel>Nom d'utilisateur</guilabel> et <guilabel>Mot de passe</guilabel> valables.</para></listitem>
<para>Cette page permet de personnaliser les couleurs et les polices de la fenêtre de définition. Une police proportionnelle pour le texte normal augmente la lisibilité, mais supprime aussi la disposition codée en dur des tableaux et autres détails similaires dans les définitions de certaines bases de données.</para>
<para>La disposition du résultat n'est pas encore réellement configurable. Néanmoins, vous pouvez décider combien d'en-têtes (un en-tête établit à quelle base de données appartient la définition) &kdict; devra placer dans le résultat. Les choix devront être explicites. Notez que les changements effectués sur cette page n'auront aucun effet jusqu'à ce que vous démarriez une nouvelle requête.</para>
<listitem><para>Ce paramètre limite le nombre de définitions que vous pouvez extraire à la fois en les choisissant dans la liste des correspondances.</para></listitem>
<term><guilabel>Résultats en mémoire</guilabel></term>
<listitem><para>Ce nombre détermine combien de résultats précédents sont contenus dans un cache interne pour un accès rapide. En fixant cette valeur à 0, vous vous privez de la capacité d'explorer à nouveau d'anciens résultats.</para></listitem>
<term><guilabel>Entrées dans l'historique</guilabel></term>
<listitem><para>Il s'agit du nombre d'entrées antérieures que la ligne de saisie mémorise. Des valeurs élevées ralentiront le démarrage et l'arrêt de &kdict;.</para></listitem>
<para>Si vous faites fréquemment appel à &kdict;, vous trouverez peut-être utile d'utiliser l'applet intégrée au tableau de bord. Récupérez l'applet via le <menuchoice><guimenu>MenuK</guimenu><guisubmenu>Menu du tableau de bord</guisubmenu><guisubmenu>Ajouter</guisubmenu><guisubmenu>Applet</guisubmenu><guimenuitem>Dictionnaire</guimenuitem></menuchoice>.</para>
<para>Le champ de saisie se comporte comme celui de la fenêtre principale de &kdict;. Quand vous appuyez sur <keycap>Entrée</keycap>, &kdict; s'ouvre et la requête démarre. Au lieu d'effectuer une saisie, vous pouvez également choisir une phrase que vous avez saisie au préalable dans la liste déroulante.</para>
<para><action>Cherche les éléments de la base de données</action> qui <link linkend="match-query">correspondent au contenu actuel</link> du presse-papiers.</para>
<term><menuchoice><guimenu>Serveur</guimenu> <guimenuitem>Demander les capacités</guimenuitem> </menuchoice></term> <listitem><para><action>Détermine quelles bases de données et stratégies sont disponibles</action> sur le serveur <productname>DICT</productname>. Appelez ce dernier une fois pour être en mesure de spécifier une stratégie de recherche et une base de données pour une requête.</para></listitem>
<term><menuchoice><guimenu>Serveur</guimenu> <guimenuitem>Informations de base de données</guimenuitem> </menuchoice></term>
<listitem><para>Sous-menu qui offre un résumé des bases de données disponibles, ainsi que des informations détaillées pour chaque base de données.</para></listitem>
<term><menuchoice><guimenu>Serveur</guimenu> <guimenuitem>Informations de stratégie</guimenuitem> </menuchoice></term>
<listitem><para><action>Affiche une liste avec de courtes descriptions des stratégies de recherche disponibles sur le serveur actuel.</action></para></listitem>
<term><menuchoice><guimenu>Serveur</guimenu> <guimenuitem>Informations sur le serveur</guimenuitem> </menuchoice></term>
<listitem><para><action>Affiche quelques informations d'état</action> (temps d'utilisation, &etc;) sur le serveur <productname>DICT</productname> actuel.</para></listitem>
<listitem><para>Sous-menu qui (dés)active les barres d'outils. Vous pouvez activer la barre d'outils principale ou la barre d'outils de requête, indépendamment.</para></listitem>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Configurer les raccourcis clavier...</guimenuitem> </menuchoice></term>
<listitem><para><action>Ouvre une boîte de dialogue pour modifier les combinaisons de touches.</action> Grâce à cette option, vous pouvez changer le raccourci clavier standard des commandes de &kdict; ou en créer de nouvelles.</para></listitem>
<term><menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Configurer les barres d'outils...</guimenuitem> </menuchoice></term>
<listitem><para><action>Ouvre une boîte de dialogue pour configurer les barres d'outils.</action> Cette option permet d'ajouter et de supprimer des boutons d'outils pour les commandes de &kdict;.</para></listitem>
<para>On peut démarrer &kdict; directement dans un terminal comme &konsole; ou <application>xterm</application>. Plusieurs options en ligne de commande sont disponibles.</para>
<listitem><para>recherche le texte donné. Placez la phrase entre guillemets si elle contient plusieurs mots. Par exemple: <command>kdict "guillemets"</command></para></listitem>
<para>&kdict; prend également en charge toutes les autres options en ligne de commande communes aux programmes &kde; et &Qt;. Vous pouvez obtenir une liste de ces options avec <userinput><option>--help</option></userinput>, <userinput><option>--help-kde</option></userinput> and <userinput><option>--help-qt</option></userinput></para>
<para>&kdict; a été écrit à l'origine en 1998 par Matthias Hölzer-Klüpfel <email>hoelzer@kde.org</email>. Actuellement, il est maintenu par Christian Gebauer <email>gebauer@kde.org</email>.</para>
<para>Outre une installation &kde; opérationnelle, &kdict; exige la bibliothèque de threads POSIX, qui est disponible sur tous les Unix modernes.</para>
<title>Obtenir et installer <command>dictd</command></title>
<para>Il faut tout d'abord installer le démon <command>dictd</command>. Pour ce faire, le plus simple est d'utiliser un paquetage précompilé. Ce type de paquetage est inclus à la fois dans <ulink url="http://www.debian.org/">Debian</ulink> et <ulink url="http://www.suse.com/">SuSE</ulink> &Linux;. Vous trouverez des paquetages qui fonctionneront sur toutes les distributions &Linux; basées sur les <productname>RPM</productname>s à l'adresse <ulink url="http://rpmfind.net/linux/RPM/">rpmfind.net</ulink>.</para>
<para>Pour compiler <command>dictd</command> vous-même, téléchargez <ulink url="ftp://ftp.dict.org/pub/dict/dictd-1.9.1.tar.gz">ftp://ftp.dict.org/pub/dict/dictd-1.9.1.tar.gz</ulink>. La compilation est simple, décompactez simplement l'archive et exécutez <userinput><command>./configure</command></userinput>, <userinput><command>make</command></userinput> et <userinput><command>make</command> <option>install</option></userinput> dans le dossier <filename class="directory">dictd</filename>. Pour installer <command>dictd</command> dans un autre dossier, vous devrez employer l'option <option>--prefix</option> du script configure. Par défaut, <command>dictd</command> sera installé dans <filename class="directory">/usr/local</filename>.</para>
<para>Téléchargez à présent quelques bases de données. L'ensemble par défaut (webster, wordnet, jargon file, foldoc, &etc;), présent sur le serveur <productname>DICT</productname> de <ulink url="http://www.dict.org">dict.org</ulink>, est disponible à l'adresse <ulink url="ftp://ftp.dict.org/pub/dict/pre/">ftp://ftp.dict.org/pub/dict/pre/</ulink>. Celles-ci sont également disponibles sous forme de paquetages <ulink url="http://www.debian.org/">Debian</ulink> et <ulink url="http://rpmfind.net/linux/RPM/">rpm</ulink>.</para>
<listitem><para>Dictionnaires de traduction pour l'africaans, l'allemand, l'anglais, le danois, l'espagnol, le français, le gallois, le grec, le hongrois, l'irlandais, l'italien, le japonais, le latin, le néerlandais (hollandais), le portugais, le russe, le serbo-croate, le slovaque, le suédois, le swahili, le tchèque et le turc.</para></listitem>
<listitem><para>Dictionnaires de traduction pour l'allemand, l'anglais, l'espagnol, le français, l'italien, le latin et le portugais.</para></listitem>
<para>D'autres bases de données sont à votre disposition sur la page de liens de <ulink url="http://www.dict.org">www.dict.org</ulink>, mais la majorité d'entre elles ne sont pas formatées pour <command>dictd</command>.</para>
<para>Chaque base de données se compose de deux fichiers: le fichier <literal role="extension">*.index</literal> contient l'index, et le fichier <literal role="extension">*.dict.dz</literal> les données proprement dites. Décompactez tous les paquetages dans le dossier de votre choix, par exemple <filename class="directory">/usr/share/dict/</filename>.</para>
<para>Vous devez créer/modifier deux fichiers de configuration. Ils sont tous les deux enregistrés dans <filename class="directory">/usr/local/etc</filename> si vous avec utilisé le préfixe d'installation par défaut (<filename class="directory">/usr/local</filename>).</para>
<para><filename>dict.conf</filename> appartient au client <command>dict</command> de base. Il ne contient qu'une ligne: <userinput>server localhost</userinput>. Celle-ci ordonne à <command>dict</command> d'utiliser le serveur local.</para>
<para>Cet exemple n'accorde que l'accès local et bloque toute connexion extérieure. Toutefois, vous pouvez utiliser plusieurs règles d'autorisation et de refus, par exemple: <programlisting>access {allow localhost allow *.workgroup deny
*}</programlisting> L'instruction de base de données configure l'emplacement de l'index et le fichier de données pour une base de données: </para>
<programlisting>database web1913 { data "/usr/share/dict/web1913.dict.dz"
<para>Si vous souhaitez faire fréquemment appel au serveur <command>dict</command>, démarrez-le automatiquement au cours du processus de mise en route de votre système. Certains des paquetages précompilés installent un script approprié, mais vous pouvez aussi adapter le script générique de type SYSV inclus dans la distribution source: <ulink url="ftp://ftp.dict.org/pub/dict/INITSCRIPT">ftp://ftp.dict.org/pub/dict/INITSCRIPT</ulink>.</para>
