&Mike.McBride; &Mike.McBride.mail;
&Jost.Schenck; &Jost.Schenck.mail;
Lisiane Sztoltz

    lisiane@conectiva.com.br

Tradução
2002-10-17
3.1
KDE Centro de Controle Índice de Ajuda Índice

## Índice de Ajuda

Na hora da gravação, para a maioria das instalações do &kde;, a função de mecanismo de busca no &khelpcenter; está desabilitada, e as preferências feitas neste módulo do &kcontrol; não terão efeito. Esperamos tê-la de volta em um futuro próximo.

O &kde; vem com uma grande quantidade de documentação para as aplicações e os componentes. Apesar de bastar apenas navegar nos manuais até encontrar a informação que procura, esta busca poderá ser uma tarefa bastante morosa. Para torná-la mais fácil, 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 fato, alguns dos motores de busca que o usuário conhece até poderão estar usando-o. Basta clicar na seção Procurar no &khelpcenter;; inserir a palavra que está procurando, clicar 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 controle tenta ajudá-lo no último ponto. Se não tiver instalado o ht://dig e se ele não veio com o seu sistema operacional, o usuário terá que obtê-lo por si próprio. Dê uma olhada na página Web do ht://dig para saber como obtê-lo e instalá-lo.

Quando você iniciá-lo pela primeira vez, você estará somente no modo de exibição, e para modificar as configurações, clique no Modo Administrador. Se você está acessando o sistema como root, vá direto ao diálogo de modificação. Se não tiver, o &kde; pedirá pela senha de superusuário.

### Uso

Existem duas coisas importantes a informar para o &kde;, pois ele pode usar no mecanismo de busca:

- onde encontrar os programas do KDE que fazem uso da busca do ht://dig

- onde buscar

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

Existem três programas que o &kde; precisa para vir junto com o ht://dig: `htdig`, `htsearch` e o `htmerge`. Para cada programa você deve fornecer o caminho completo, incluindo o nome do programa, como por exemplo: `/usr/bin/htdig`.

Onde exatamente estes programas são instalados, depende do seu sistema operacional ou distribuição. No entanto, existem algumas boas dicas de locais que você deve tentar:

- O `htdig` e o `htmerge` são freqüentemente encontrados em `/usr/bin/` ou em algo como `/usr/local/www/htdig/bin/`.

- o comando `htsearch` é freqüentemente encontrado em uma sub-pasta chamada `cgi-bin`, como por exemplo `/usr/local/httpd/cgi-bin/`.

Para saber, por exemplo, onde o `htdig` é instalado, você sempre pode digitar `whereis htdig` no console. O `whereis` procurará o comando especificado no caminho de execução padrão das pastas. No entanto, pastas como `cgi-bin` são freqüentemente colocadas no caminho padrão.

#### Caminhos de Busca e Escopo

Nesta seção, você pode escolher que recursos de ajuda devem ser indexados, &ie; estar disponíveis no mecanismo de busca.

No quadro Escopo você pode selecionar alguns recursos típicos que você deseja que sejam indexados, &ie; os arquivos de ajuda do &kde; e as informações oferecidas pelos comandos `man` e `info`. Note que algumas delas ainda pode estar desabilitadas, o que significa que o suporte a elas ainda não foi adicionado.

Talvez você tenha arquivos adicionais, que deseja acessar usando a característica de busca do &khelpcenter;. Por exemplo, você pode ter uma referência HTML instalada em `/home/jdoe/docs/meuhtml`. Adicionando este caminho na lista de caminhos de busca adicionais, você faz com que o documento fique disponível para a busca do &khelpcenter; também. Apenas clique no botão Adicionar e um diálogo de arquivo pedirá a você por um diretório adicional de busca. Selecione `/home/jdoe/docs/meuhtml` e clique em OK. Para remover um caminho adicional, basta selecioná-lo e clicar em Remover.

As suas alterações no escopo e os locais de pesquisa adicionais não farão efeito se não clicar no botão Gerar o índice.