&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 muita documentação sobre os aplicativos e componentes. É possível apenas navegar pelos manuais até você encontrar o pedaço de informação que procura, e isto pode ser uma tarefa que consuma bastante tempo. Para tornar esta tarefa mais fácil, o &kde; oferece uma busca com texto completo, usando um programa chamado ht://dig. Ele funciona de modo similar à ferramentas de busca da web, e de fato, em alguns mecanismos de busca você agora até mesmo usa-o. Apenas clique na aba Procurar no &khelpcenter;, digite a palavra que você está procurando, clique em Procurar e divirta-se!

No entanto, para fazer uso desta característica, o ht://dig deve estar instalado no sistema e o &kde; deve estar configurado. Se você não possui o ht://dig instalado e ele não veio junto com o seu sistema operacional, você deve obter o ht://dig sozinho. Dê uma olhada na página do ht://dig sobre como carregá-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.

Suas modificações para o escopo e caminhos adicionais de busca não terão efeito se você não clicar no botão Construir índice .