## Index d'aide

Au moment de la rédaction de ce document, l'ensemble de la fonction de moteur de recherche du ¢reAide; est désactivée pour la plupart des installations de &kde;. Les paramètres définis dans ce module du ¢reConfiguration; n'auront aucun effet. Nous espérons la réactiver dans une version future..

&kde; est fourni avec une volumineuse documentation pour les applications et les composants. Vous pouvez vous contenter de parcourir les manuels jusqu'à ce que vous trouviez l'objet de votre recherche, mais la tâche peut s'avérer très longue. Pour vous faciliter la vie, &kde; offre une recherche dans tout le texte grâce à un programme appelé ht://dig. Il fonctionne d'une manière presque similaire aux moteurs de recherche sur le web. En fait, certains moteurs de recherche que vous connaissez pourraient même l'utiliser. Cliquez simplement sur l'onglet Recherche dans le ¢reAide;, saisissez le mot que vous recherchez, cliquez sur Chercher et c'est tout !

Toutefois, pour bénéficier de cette fonctionnalité, il faut installer ht://dig sur votre système et configurer &kde; pour pouvoir l'utiliser. Ce module de configuration tente de vous aider à réaliser cette dernière tâche. Si vous n'avez pas installé ht://dig et s'il est n'est pas fourni avec votre système d'exploitation, procurez-vous ht://dig. Consultez la page web ht://dig sur la manière de le télécharger et de l'installer.

La première fois que vous démarrez, vous êtes en mode affichage uniquement. Pour modifier vos paramètres, cliquez sur Mode administrateur. Si vous êtes connecté en tant que `root`, passez directement à la boîte de dialogue des modifications. Dans le cas contraire, &kde; vous demandera un mot de passe root.

### Utilisation

Pour que &kde; puisse utiliser le moteur de recherche thématique, deux éléments lui sont nécessaires :

- où trouver les programmes ht://dig que KDE utilise pour la recherche thématique

- où effectuer la recherche

#### Les programmes ht://dig

Trois programmes nécessaires à &kde; sont fournis avec ht://dig : `htdig`, `htsearch` et `htmerge`. Indiquez pour chaque programme son chemin complet, y compris son nom, &pex; : `/usr/bin/htdig`.

L'endroit exact où sont installés ces programmes dépend de votre système d'exploitation ou de votre distribution. Voici toutefois quelques astuces que vous aimeriez peut-être essayer :

- `htdig` et `htmerge` se trouvent souvent dans `/usr/bin/` ou dans un endroit comme `/usr/local/www/htdig/bin/`.

- la commande `htsearch` se trouve souvent dans un sous-dossier appelé `cgi-bin`, par exemple `/usr/local/httpd/cgi-bin/`.

Pour découvrir par exemple où `htdig` est installé, vous pouvez toujours saisir `whereis htdig` sur la console. `whereis` recherchera la commande spécifiée dans les dossiers du chemin d'exécution par défaut. Le plus souvent cependant, des dossiers tels que `cgi-bin` ne sont pas dans le chemin d'exécution par défaut.

#### Portée et chemins de recherche

Dans cette section, vous pouvez choisir les ressources d'aide qui devraient être indexées, &cad; rendues accessibles au moteur de recherche.

Le cadre Sphère d'application permet de choisir certaines ressources classiques que vous souhaitez indexer, &cad; les fichiers d'aide de &kde; et les informations qu'offrent les commandes `man` et `info`. Notez que certaines d'entre elles peuvent encore être désactivées, ce qui signifie que leur gestion n'a pas encore été ajoutée.

Peut-être avez-vous d'autres fichiers auxquels vous désirez accéder via la fonction de recherche thématique du ¢reAide;. Par exemple, vous pourriez avoir installé une référence HTML dans `/home/jdupont/docs/selfhtml`. En ajoutant ce chemin à la liste des chemins de recherche additionnels, vous rendez cette documentation également accessible à la recherche thématique du ¢reAide;. Cliquez simplement sur le bouton Ajouter, et une boîte de dialogue vous demandera un dossier de recherche additionnel. Choisissez `/home/jdupont/docs/selfhtml` et cliquez sur OK. Pour supprimer un chemin de recherche additionnel, choisissez-le simplement et cliquez sur Supprimer.

Vos changements dans la portée et les chemins de recherche additionnels n'entreront pas en vigueur si vous ne cliquez pas sur le bouton Construire l'index.