## Índex d'ajuda

En el moment d'escriure aquest document, en la majoria d'instal·lacions del &kde; tota la funcionalitat completa del motor de recerca en &khelpcenter; està desactivada i les preferències en aquest mòdul del &kcontrol; no tindran efecte. Esperem tornar a recuperar-lo en una futura versió.

El &kde; inclou una gran quantitat de documentació per a aplicacions i components. Encara que és possible navegar pels manuals fins a trobar la informació que esteu cercant, això pot consumir una gran quantitat de temps. Per a facilitar-vos la tasca, el &kde; ofereix una completa recerca de text emprant un programa anomenat ht://dig. Funciona de manera molt semblant als cercadors de la web, de fet els cercadors que empreu potser també l'usen. Simplement cliqueu a sobre de la pestanya Cerca en el &khelpcenter;, introduïu-hi la paraula que esteu cercant, cliqueu a Cerca i a gaudir-ho!

Encara que, per a poder emprar aquesta propietat, heu d'instal·lar ht://dig al vostre sistema i el &kde; té que estar configurat per a poder emprar-lo. Aquest mòdul de control intenta ajudar-vos en això últim. Si no heu instal·lat ht://dig i no estava inclòs amb el vostre sistema operatiu heu d'aconseguir ht://dig pel vostre compte. Feu un cop d'ull a la pàgina de ht://dig a sobre de com descarregar-lo i instal·lar-lo.

Quan s'engega per primera vegada, se us mostrarà en el mode de sols visualització. Per a modificar-ne l'arranjament, cliqueu a sobre de Mode administrador. Si heu accedit al sistema com a `root`, se us mostrarà directament el diàleg de modificació. Sinó, el &kde; us demanarà la contrasenya d'un superusuari.

### Ús

Hi ha dues coses importants que indicar-li al &kde; de manera que aquest puga emprar el motor de recerca de text complet:

- el lloc a on trobar els programes ht://dig que el KDE usarà per a la recerca de text complet

- a on cercar

#### Els programes ht://dig

Hi ha tres programes que el &kde; necessita el que inclou a ht://dig: `htdig`, `htsearch` i `htmerge`. Per a cada programa haureu de proporcionar la ruta completa incloguen el nom del programa, per exemple: `/usr/bin/htdig`.

El lloc a on estan instal·lats aquests programes depèn del vostre sistema operatiu o de la vostra distribució. Encara que, hi ha algunes possibilitats força freqüents que podeu intentar:

- `htdig` i `htmerge` habitualment es troben en `/usr/bin/` o en `/usr/local/www/htdig/bin/`.

- el comandament `htsearch` habitualment es troba en una subcarpeta anomenada `cgi-bin`, per exemple `/usr/local/httpd/cgi-bin/`.

Per a cercar a on està instal·lat per exemple `htdig` sempre podeu introduir `whereis htdig` en la consola. `whereis` cercarà el comandament específic en les rutes estàndard de carpetes d'executables (la «path»). Encara que, directoris com `cgi-bin` no estan habitualment en la ruta estàndard dels executables.

#### Àmbit i rutes de recerca

En aquesta secció podeu escollir quins recursos d'ajuda haurien de ser indexats, &ead;, si haurien d'estar disponibles per a ser trobats pel motor de recerca.

En el marc Àmbit podeu seleccionar alguns recursos típics que desitgeu que estiguin indexats, &pex;, els fitxers d'ajuda del &kde; i la informació oferta pels comandaments `man` i `info`. Tingueu present que alguns d'aquests poden estar deshabilitats, el que significa que encara no s'ha afegit suport per als mateixos.

Potser disposeu de fitxers addicionals als que desitgeu accedir emprant la propietat de recerca de text complet del &khelpcenter;. Per exemple, podeu tenir una referència HTML instal·lada en `/home/juan/docs/elsmeushtml`. Si afegiu aquesta ruta a la llista de rutes de recerca addicionals fareu que aquesta documentació també estigui disponible al cercador de text complet de &khelpcenter;. Simplement cliqueu a sobre del botó Afegeix i un diàleg de fitxers us sol·licitarà un directori addicional de recerca. Seleccioneu `/home/juan/docs/mishtml` i cliqueu a Bé. Per a eliminar una ruta addicional de recerca, simplement seleccioneu-la i cliqueu a Esborra.

Els vostres canvis a l'àmbit i les rutes addicionals de recerca no tindran efecte si no cliqueu a sobre del botó Genera l'índex de recerca.