&Mike.McBride; &Mike.McBride.mail;
&Jost.Schenck; &Jost.Schenck.mail;
José Pires

    jncp@netcabo.pt

Tradução
2002-10-17
3.1
KDE KControl Índice da Ajuda Índice

## Índice da Ajuda

Na altura em que isto foi escrito, na maioria das instalações do &kde;, o motor de busca no &khelpcenter; está desactivado por inteiro, de modo que as configurações feitas neste módulo do &kcontrol; não terão efeito. Esperamos tê-lo de volta numa próxima versão.

O &kde; vem com uma grande quantidade de documentação para as aplicações e os componentes. Enquanto que basta apenas navegar nos manuais até encontrar essa informação que anda à procura, esta poderá ser uma tarefa bastante morosa. Para a tornar mais fácil para si, o &kde; oferece a procura por texto completo através de um programa chamado ht://dig. Funciona de um modo muito semelhante aos motores de busca na Web; de facto, alguns dos motores de busca que o utilizador conheça até o possam usar. Basta carregar na secção Procurar no &khelpcenter;; indique a palavra que está à procura, carregue em Procurar e divirta-se!

Contudo, para tirar partido desta funcionalidade, o ht://dig tem de estar instalado no seu sistema e o &kde; necessita ser configurado para tirar partido do mesmo. Este módulo de controlo tenta ajudá-lo no último ponto. Se não tiver instalado o ht://dig e se este não veio com o seu sistema operativo, o utilizador terá de o obter por si próprio. Dê uma vista de olhos na página Web do ht://dig para saber como o obter e o instalar.

Ao executar o módulo fica em modo de visualização. Para modificar a sua configuração carregue em Modo de Administração. Se estiver ligado como root, irá parar directamente à janela de modificação. Caso contrário, o &kde; pedir-lhe-á a senha de super-utilizador.

### Utilização

Existem duas coisas importantes para indicar ao &kde; para que possa tirar partido do motor de busca por texto completo:

- onde encontrar os programas do ht://dig que o KDE utiliza para a pesquisa por texto completo

- onde procurar

#### Os Programas do ht://dig

Existem três programas que o &kde; necessita e que vêm com o ht://dig: o `htdig`, o `htsearch` e o `htmerge`. Para cada um dos programas terá de indicar a localização completa e que inclui o nome do programa, como por exemplo: `/usr/bin/htdig`.

A localização exacta da instalação desses programas depende do seu sistema operativo ou distribuição. Contudo, existem dois palpites que o utilizador poderá tentar:

- o `htdig` e o `htmerge` estão normalmente em `/usr/bin/` ou em algo do tipo `/usr/local/www/htdig/bin/`.

- o comando `htsearch` está normalmente dentro de uma pasta `cgi-bin`, como por exemplo `/usr/local/httpd/cgi-bin/`.

Para descobrir onde, por exemplo, o `htdig` está instalado poderá sempre tentar o comando `whereis htdig` na consola. O `whereis` irá procurar pelo comando indicado por todas as pastas padrão de procura. Contudo, as pastas do tipo `cgi-bin` não costumam estar nas pastas de execução padrão.

#### Âmbito e Localizações de Pesquisa

Nesta secção poderá escolher quais os recursos de ajuda que deverão ser indexados, &ie;, tornados disponíveis ao motor de busca.

Na área de Âmbito, o utilizador poderá seleccionar alguns recursos típicos para indexar, &ie;, os ficheiros de ajuda do &kde; e a informação oferecida pelos comandos `man` e `info`. Repare que alguns destes poderão à mesma estar desactivados, o que significa que o suporte para os mesmos ainda não foi adicionado.

O utilizador poderá também ter ficheiros, aos quais deseje aceder usando a funcionalidade de procura de texto do &khelpcenter;. Por exemplo, poderá ter uma referência em HTML instalada em `/home/ze/docs/html_próprio`. Ao adicionar esta localização à lista de pesquisas adicionais, torna esta documentação disponível à procura do &khelpcenter;. Basta carregar no botão Adicionar para que uma janela de ficheiros lhe pergunte por uma pasta de pesquisa adicional. Seleccione a pasta `/home/ze/docs/html_próprio` e carregue em OK. Para remover uma pasta de pesquisa adicional, basta seleccioná-la e carregar em Remover.

As suas alterações ao âmbito e os locais de pesquisa adicionais não tomarão efeito se não carregar no botão Criar o índice.