## Indice dell'aiuto

All'epoca della stesura di questo manuale, per la maggior parte delle installazioni di &kde; la funzione di ricerca su tutto il testo è disabilitata in &khelpcenter;, e le impostazioni effettuate in questo modulo del centro di controllo non hanno effetto. Speriamo che la funzione venga restituita nelle prossime versioni.

&kde; viene fornito con molta documentazione per le applicazioni ed i componenti. Sebbene sia possibile sfogliare i manuali finché non si trova l'informazione che si cerca, ciò è un compito lento e noioso. Per renderti la vita più semplice, &kde; permette la ricerca su tutto il testo con l'aiuto di un programma chiamato ht://dig. Funziona in modo simile ai motori di ricerca del Web, ed in effetti alcuni motori noti potrebbero usarlo. Fai clic sulla linguetta Cerca di &khelpcenter;, inserisci la parola che ti interessa, fai clic su Search ed oplà!

Però per far uso di questa funzione, ht://dig deve essere installato sul sistema e &kde; deve essere configurato in modo da farne uso. Questo modulo di controllo è fatto per aiutarti a fare la configurazione. Se l'applicazione ht://dig non è installata e non è fornita col tuo sistema operativo, devi scaricarla da solo. Dai un'occhiata alla pagina home di ht://dig per scoprire come scaricarlo e installarlo.

Quando avvii per la prima volta, sei solo in modalità visualizzazione. Per modificare le impostazioni, fai clic su Modalità amministratore. Se sei entrato in &kde; da `root`, potrai accedere direttamente alla finestra delle modifiche. In caso contrario, &kde; ti chiederà la password di amministratore.

### Uso

Ci sono due cose importanti da dire a &kde; perché possa usare il motore di ricerca su tutto il testo:

- dove trovare i programmi di ht://dig che KDE usa per fare una ricerca su tutto il testo

- dove cercare

#### I programmi ht://dig

Ci sono tre programmi che &kde; usa che sono distribuiti assieme ad ht://dig: `htdig`, `htsearch` e `htmerge`. Per ciascuno di essi dovrai fornire il percorso completo, incluso il nome del programma, ad esempio: `/usr/bin/htdig`.

Dove esattamente sono installati questi programmi dipende dal sistema operativo o dalla distribuzione. Però, ci sono buone probabilità che i seguenti suggerimenti siano esatti:

- `htdig` e `htmerge` si trovano spesso in `/usr/bin/` o in qualcosa come `/usr/local/www/htdig/bin/`.

- Il comando `htsearch` spesso si trova in una cartella chiamata `cgi-bin`, ad esempio `/usr/local/httpd/cgi-bin/`.

Per trovare dove si trovi (ad esempio) `htdig` è possibile usare `whereis htdig` dalla console. Il comando `whereis` cercherà il comando specificato nelle cartelle che fanno parte dei percorsi standard per gli eseguibili. Spesso però, cartelle come `cgi-bin` non fanno parte dei percorsi standard.

#### Ambito e percorsi di ricerca

In questa sezione puoi scegliere quali risorse debbano essere indicizzate, &ie; rese disponibili al motore di ricerca.

Nel riquadro Contesto puoi selezionare alcune risorse tipiche da indicizzare, &ie; i file di aiuto di &kde; e le informazioni offerte dai comandi `man` e `info`. Nota che alcune di queste sono ancora disabilitate, perché la loro gestione non è ancora stata aggiunta al programma.

Potresti avere altri file a cui vuoi accedere attraverso la ricerca con &khelpcenter;. Ad esempio, potresti avere un manuale di riferimento su HTML installato `/home/jdoe/docs/selfhtml`. Aggiungendo questo percorso all'elenco dei percorsi di ricerca aggiuntivi renderai anche questa documentazione disponibile per la ricerca sul testo di &khelpcenter;. Fai clic su Aggiungi e una finestra di selezione di file ti chiederà la cartella di ricerca aggiuntiva. Seleziona `/home/jdoe/docs/selfhtml` e fai clic su OK. Per rimuovere un percorso di ricerca aggiuntivo, selezionalo e fai clic su Elimina.

Le modifiche all'ambito ed ai percorsi di ricerca aggiuntivi non avranno effetto se non fai clic sul pulsante Genera indice.