docs.kde.org

Mike McBride

Jost Schenck

Tradução: Lisiane Sztoltz
Revisão 3.1 (2002-10-17)

Índice

Índice de Ajuda
Uso

Índice de Ajuda

Nota

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 os aplicativos 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 frequentemente encontrados em /usr/bin/ ou em algo como /usr/local/www/htdig/bin/.

  • o comando htsearch é frequentemente encontrado em uma sub-pasta chamada cgi-bin, como por exemplo /usr/local/httpd/cgi-bin/.

Dica

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 frequentemente colocadas no caminho padrão.

Caminhos de Busca e Escopo

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

No quadro Escopo você pode selecionar alguns recursos típicos que você deseja que sejam indexados, isto é 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.

Importante

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.

 


docs.kde.org