# Manual do KFind

Miroslav
Flídr

    flidr@kky.zcu.cz

Martin
Hartig

    hartig@mathematik.uni-kl.de

Mark
Roberts

    mar2@scigen.co.uk

Sérgio
Fernandes

    sergio_fernandes@rocketmail.com

Tradução da Documentação
21/06/1998
0.04.01
KDE
KFind
Procurar ficheiros

Este Manual descreve a versão 0.4 do KFind

## Introdução

O Kfind procura ficheiros que satisfazem determinado critério, dentro da hierarquia de directorias.

Muitas vezes sabe que um ficheiro está 'algures po aí', mas não consegue lembrar-se onde está, mesmo com um bom esforço. Então o KFind é a ferramenta exacta para esse problema. Tendo encontrado o(s) ficheiro(s) pretendido(s), pode:

- guardá-los,

- apagá-los,

- mudar as propriedades do ficheiro,

- armazená-los em arquivos e/ou

- abrir a directoria que contém o(s) ficheiro(s) no gestor de ficheiros (Kfm).

Espero que ache este programa util e apreciarei qualquer sugestão e comentários.

`Miroslav Flídr` flidr@kky.zcu.cz.

## Instalação

### Como Obter o KFind

O KFind é parte do projecto KDE http://www.kde.org. O KFind pode ser encontrado em ftp://ftp.kde.org/pub/kde/, o site de ftp principal do projecto KDE. Também existem ligações para muitos espelhos FTP.

### Requesitos

Para compilar com sucesso o KFind, necessita das últimas versões de `libkdecore` e `libkfm`. Todas as librarias requeridas como o KFind em si podem ser encontrados em ftp://ftp.kde.org/pub/kde/.

### Compilação e Instalação

O Kfind é normalmente uma parte integrante de um lançamento do KDE e por conseguinte será instalado automáticamente com outras aplicações KDE durante o curso normal da instalação do KDE.

Se necessita compilar e instalar o KFind você mesmo no seu sistema, digite o seguinte na directoria base da distribuição do KFind:

    % ./configure
    % make
    % make install

Como o KFind usa o `autoconf`, não deve ter problemas para o compilar. Se tiver problemas, por favor relate-as para as listas de mailing do KDE.

### Configuração

A configuração é normalmente realizada no diálogo das Preferências; veja a secção do utilizador deste manual para mais detalhes. Uma descrição técnica da configuração do kfind segue para as partes interessadas:

O Kfind lê os parametros de configuração a partir de um ficheiro de configuração (normalmente `˜/.kde/share/config/kfindrc`).

Este ficheiro contém informação acerca da gravação dos resultados de pesquisas, arquivadores disponiveis e outros parametros de configuração; estes parametros podem ser editados a partir do diálogo de Preferencias do `Kfind`.

Informação Geral:o ficheiro de recursos é constituido por secções. Cada secção é iniciada por um título de cabeçalho em paranteses rectos i.é:`[Gravando]`.

A informação a seguir ao cabeçalho está relacionada com um aspecto específico da operação do `Kfind`.

Gravando Configuração:O ficheiro de configuração contém o nome e o formato do ficheiro que irá ser usado para gravar os resultados da pesquisa. Estes parametros são armazenados da seguinte maneira:

    [Saving]
    Format=HTML
    Filename=/root/result.html

Onde a entrada `Format` pode ter valores `HTML` ou `Plain Text`.

Configuração de Arquivadores: Os Arquivadores disponiveis para o `kfind` são especificados na entrada kfindrc `[Archiver Types]` da seguinte maneira:

    [Archiver Types]
    Archivers=tar;zip;zoo;

E cada arquivador é descrito detalahdamente pela sua entrada:

    [tar]
    ExecOnCreate=tar cf %a -C %d %n
    ExecOnUpdate=tar uf %a -C %d %n
    Comment=Tar

A primeira linha contém o comando a ser executado quando criar um novo ficheiro e a segunda é para actualizar arquivos existentes. A terceira é o comentário usado para a descrição do arquivo no diálogo das Preferencias. Pode usar-se variáveis com estes comandos, que são denotados por um símbolo de &percnt;.

The following is a list of legal command line variables:

`&percnt;a` Nome completo do arquivo

`&percnt;f` O nome normal do ficheiro

`&percnt;d` A directoria anterior. Se o argumento passado é um ficheiro ( não uma directoria ) então ser-lhe-á dada a directoria onde se encontra o ficheiro.

`&percnt;n` O nome do ficheiro. Se o argumento passado é uma directoria então isto é o nome desta directoria.

## Fundamentais do Ecrã

Nesta secção será descrita muito brevemente a interface do Kfind.

A janela do Kfind está dividida em três áreas: barra de ferramentas, diálogo dos parâmetros de pesquisa, e uma área de visualização. Esta área e a barra de estado ficam visiveis apenas depois de receberem resultados da pesquisa.

### Barra de Ferramentas

Iniciar Pesquisa

  Inicia uma nova pesquisa usando os parâmetros especificados no diálogo de parâmetros.

Nova Pesquisa

  Limpa os resultados e começa com novos parâmetros.

Parar Pesquisa

  Termina o processo de pesquisa.

Abrir

  Pergunta ao Kfm para iniciar a ligação por defeito para o ficheiro seleccionando.

Adicionar ao arquivo

  Adiciona o ficheiro seleccionado ao arquivo escolhido.

Apagar

  apaga ficheiros seleccionados e diz ao Kfm para refrescar a directoria.

Propriedades

  Mostra as propriedades do ficheiro seleccionado.

Abrir a Pasta que Contém

  Diz ao Kfm para abrir a pasta que contém o ficheiro seleccionado.

Gravar Resultados da Pesquisa

  Grava os resultados para o ficheiro especificado no diálogo em Opções->Preferencias.

Ajuda

  Mostra a documentação do KFind.

Sair

  Sai do KFind.

### Diálogo do Parâmetros de Pesquisa

Este diálogo é a parte principal do `KFind`. É usada para especificar os parâmetros para o utilitário de pesquisa. Existem três grupos de parâmetros de pesquisa:

Nome e localização

  Este diálogo é usado para especificar um nome de ficheiro a localizar. Este nome de ficheiro é introduzido na caixa pendente e pode conter os seguintes caracteres especiais:

  - ? condiz com qualquer caracter

  - * condiz com qualquer sequência de caracteres

  - &lsqb; ] condiz com uma definição de um conjunto de caracteres, por ex.: &lsqb;a-zA-Z0-9] condiz com letras maiúsculas e minúsculas e digitos.

  - \ símbolo é alfanúmerico ou um ponto

  A caixa pendente armazena a história dos nomes. O botão Examinar é usado para especificar a directoria onde a pesquisa será efectuada. Se quer que a pesquisa entre nas subdirectorias, especifique-o com o botão de activação Incluir supastas.
Data de Modificação

  Este diálogo permite pesquisar ficheiros criados ou modificados dentro de um período de tempo especifico.

Advançado

  Este diálogo permite procurar por tipos especificos de ficheiros, por ex. documentos Postscript, imagens JPEG ou ficheiros de som WAV.

### Área de Visualização

A área de visualização contém resultados od processo de pesquisa. Depois de um ficheiro ter sido seleccionado, as funções abrir, adicionar ao arquivo, apagar, propriedades e abrir pasta que contém ficam activadas. O duplo clique causa a execução.

## As Opções do Menu

### Ficheiro

As funções seguintes estão disponiveis a partir do menu ficheiro:

Abrir

  Esta opção chama o kfm para abrir o ficheiro seleccionado correntemente, usando a ligação por defeito, i.é., ficheiros de programas serão executados, ficheiros de texto iniciarão o editor de textos, etc. Esta acção também pode ser realizada através de um duplo clique no nome do ficheiro da lista.

Adicionar ao arquivo

  Adiciona o ficheiro seleccionado ao arquivo.

Apagar

  Apaga o ficheiro seleccionado.

Propriedades

  Permite que as propriedades do ficheiro seleccionado sejam alteradas.

Abrir a Pasta Que Contém

  Abra a directoria contendo o ficheiro seleccionado numa janela do gestor de ficheiros (KFM)

Gravar Pesquisa

  Grava a lista com os ficheiros seleccionados

Sair

  Sai do `Kfind`

### Editar

As opções deste menu estão desactivadas.

### Opções

A partir deste menu pode iniciar o diálogo das preferências. A primeira alça do diálogo das preferências permite-lhe seleccionar o nome e o formato do ficheiro onde os resultados da pesquisa são armazenadas. A segunda alça mostra os tipos de ficheiros disponiveis e os detalhes dos arquivadores.

Gravar

  Especifica o nome do ficheiro onde os resultados da pesquisa são armazenados. Por defeito é `.kfind-results.html` localizado na pasta pessoal do utilizador. Se for escolhido outro nome, pode-se especificar o formato dos resultados armazenados. Os formatos suportados são o HTML e Texto (.txt).

Arquivadores

  Este diálogo permite visualizar (e no futuro, provávelmente editar) as definições do arquivo usadas pela função Adicionar ao Arquivo.

### Ajuda

>Mostra informação acerca do KFind e da documentação do KFind.

## Epílogo

### Desenvolvedores

Miroslav Flídr

  E-Mail: flidr@kky.zcu.cz

Mario Weilguni;

  E-Mail: mweilguni@kde.org

### Autores

Miroslav Flídr

  E-Mail: flidr@kky.zcu.cz

Martin Hartig

  E-Mail: hartig@mathematik.uni-kl.de

Mark Roberts

  E-Mail: mar2@scigen.co.uk

Eric Bischoff

  - Editor E-mail: ebisch@cybercable.tm.fr