Mike
McBride
Jost
Schenck
José
Pires

    jncp@rnl.ist.utl.pt

Tradução
2000-10-21
1.00.00
KDE
KControl
Índice da Ajuda
Índice

# Índice da Ajuda

## Introdução

O KDE 2.0 vem com um conjunto de documentação para as aplicações e componentes. Ainda que seja possível apenas navegar nos manuais até encontrares aquele tópico de informação de que andas à procura, esta pode ser uma tarefa bastante lenta. Para torná-la mais simples para ti, o KDE oferece a pesquisa por texto completo usando um programa chamado ht://dig. Funciona de um modo muito parecido com o dos motores de busca; de facto, alguns dos motores de busca que vês podem estar a utilizá-lo. Basta carregares na página "Procurar" no Centro de Ajuda do KDE, indicares a palavra de que andas à procura, carregares em Procurar e diverte-te!

Contudo, para tirares partido desta funcionalidade, o ht://dig tem de estar instalado no teu sistema e o KDE tem de estar configurado para o utilizar. Este módulo de controlo tenta ajudar-te a resolver a última questão. Se não tiveres instalado o ht://dig e não vinha com o teu sistema operativo tens de o obter tu próprio. Vê na página do ht://dig como o obteres e o instalares.

## Utilização

Existem duas coisas importantes a indicar ao KDE para que possa tirar partido do motor de busca:

- onde encontrar o programa ht://dig que o KDE utiliza para a pesquisa

- onde procurar

### Os Programas do ht://dig

Existem três programas que o KDE necessita que vêm com o ht://dig: o `htdig`, o `htsearch` e o `htmerge`. Para cada programa, tens de indicar a localização completa, incluindo o nome do programa, por exemplo: `/usr/bin/htdig`.

A localização exacta destes programas depende do teu sistema operativo ou distribuição. Contudo, existem alguns bons palpites que podes tentar:

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

- o comando `htsearch` está normalmente numa sub-directoria chamada `cgi-bin`, como por exemplo `/usr/local/httpd/cgi-bin/`.

Para descobrires onde, por exemplo, o programa `htdig` está instalado podes sempre escrever na consola `whereis htdig`. O `whereis` irá procurar pelo comando especificado nas directorias de execução normais. Porém, as directorias como a `cgi-bin` não estão normalmente numa directoria de execução.

### Âmbito e Locais de Pesquisa

Nesta secção podes escolher que recursos de ajuda devem ser indexados, i.e., tornados disponíveis ao motor de busca.

Na área Âmbito podes seleccionar alguns recursos típicos que queiras indexar, i.e. os ficheiros de ajuda do KDE e a informação dos comandos `man` e `info`. Repara que alguns destes podem ainda estar desactivados, o que significa que o suporte para eles ainda não foi adicionado.

Talvez tenhas ficheiros adicionais aos quais queiras aceder utilizando a pesquisa de texto do Centro de Ajuda do KDE. Por exemplo, podes ter uma referência em HTML instalada em `/home/jdoe/docs/selfhtml`. Ao adicionares esta localização à lista de directorias de pesquisa, passas a disponibilizar também esta documentação na pesquisa do Centro de Ajuda. Basta carregares no botão Adicionar e uma janela de ficheiros pedir-te-á uma nova directoria de pesquisa. Selecciona `/home/jdoe/docs/selfhtml` e carrega em OK. Para removeres uma directoria de pesquisa, basta seleccioná-la e carregares em Apagar.

As tuas modificações no âmbito e nas directorias de pesquisa não tomarão efeito se não carregares no botão Gerar índice....

### Seleccionar a língua

Podes seleccionar a língua na qual desejas os ficheiros de ajuda através da opção Configuração da Língua

## Autor da Secção

Esta secção foi escrita por: Jost Schenck jost@schenck.de

Alterações menores: Mike McBride mpmcbride7@yahoo.com