# Manual do &kfind;

## Introdução

O &kfind; é um utilitário de busca de arquivo do &kde;.

### Iniciando o &kfind;

A ferramenta Procurar Arquivos é um método útil para buscar por arquivos específicos em seu computados, ou para procurar por arquivos que correspondem a um determinado padrão. Um exemplo disto pode incluir a busca por arquivos de um tipo em particular ou que possuam determinadas letras no seu nome. Você pode carregar este utilitário no &konqueror; (no modo de gerenciador de arquivos) selecionando &Ctrl; F Ferramentas Procurar arquivo no menu. Se você deseja usar o &kfind; como um aplicativo independente, lance-o usando o &krunner;.

## Procurando Arquivos

### A Aba Nome/Localização

Ao iniciar o &kfind;, você verá uma janela muito simples. Digite o nome do arquivo que está procurando na caixa de texto rotulada Nome:. Você pode usar curingas para correspondência e um ponto e vírgula (;) para separar diversos nomes.

Selecione uma pasta a partir da qual deseja procurar digitando-a no campo Procurar em: ou clicando em Navegar... (você pode alternar a exibição de arquivos e pastas ocultas na janela usando os atalhos &Alt;. ou F8) e pressionando &Enter; ou clicando em Procurar. Use o botão Parar para cancelar a busca. O resultado de uma busca pode ser salvo em formato &HTML; ou em texto simples com o botão Salvar como....

Se a opção Incluir subpastas estiver selecionada, todas as subpastas a partir da pasta que você selecionou serão pesquisadas também. Se você ativar Diferenciar maiúsculas de minúsculas, o &kfind; somente procurará arquivos com a correspondência exata de nomes. Ativar a opção Mostrar arquivos ocultos incluirá este tipo de arquivo na sua pesquisa. Selecionar Usar índice de arquivos lhe permite usar os índices de arquivos criados pelo pacote locate para acelerar a pesquisa.

Você pode usar os seguintes caracteres curingas para os nomes de arquivo ou pasta:

O Asterisco *

- O asterisco representa qualquer número de caracteres faltando (incluindo zero), o que significa ⪚ procurar por `marco*` pode encontrar os arquivos `marco`, `marco.png` e `marco_não_pode_ler_isto.kwd`. `mar*.kwd` pode encontrar `maresia.kwd` e `marco_não_pode_ler_isto.kwd`.

O Ponto de Interrogação ?

- Ao contrário do asterisco, o ponto de interrogação representa um único caractere, logo `marc?` encontrará `marco`, mas `marco?` não encontrará nada, nem mesmo nossos arquivos chamados `marco` e `marco.png`. Você pode colocar quantos pontos de interrogação desejar no termo de busca, eles encontrarão exatamente o número informado de caracteres.

O Conjunto de Caracteres [...]

- Isto corresponde a qualquer um dos caracteres entre os colchetes.

É claro que você pode combinar dois ou mais caracteres curingas em um único termo de pesquisa.

Os resultados de sua pesquisa serão exibidos na caixa abaixo. Um clique com o &RMB; em uma seleção nesta caixa abre um menu de contexto com uma lista de ações para os arquivos ou pastas selecionados.

### A Aba Conteúdo

Tipo de arquivo

- Aqui você pode especificar o tipo de arquivo que você está procurando.

Contendo o texto

- Digite a palavra ou frase que os arquivos que você procura devem conter. Observe: Se você fizer isto numa pasta com muitos arquivos ou habilitar o Incluir subpastas na aba Nome/Localização, a busca pode demorar um bom tempo.

  Esta opção não funcionará para todos os arquivos listados em Tipo de arquivo. Somente os seguintes tipos de arquivos são suportados:

  - Arquivos texto, ⪚ código-fonte e arquivos `README`

  - >&kword;= 1.2

  - &kpresenter; >= 1.2

  - &kspread; >= 1.2

  - OpenOffice.org Writer / LibreOffice Writer

  - OpenOffice.org Impress / LibreOffice Impress

  - OpenOffice.org Calc / LibreOffice Calc

  - Calligra Words

  - Calligra Sheets

  - Calligra Stage

Diferenciar maiúsculas de minúsculas

- Se você habilitar esta opção, o &kfind; somente encontrará texto nos arquivos com a correspondência exata de caixa, ⪚ `MARCO` somente corresponderá à MARCO, e não à Marco.

Expressão regular

- Se tiver instalado a ferramenta &kregexpeditor; do pacote playground/utils do servidor git do &kde;, você terá esta opção adicional. Habilitando-a será permitido buscar por uma regexp ou expressão regular. Uma regexp é uma maneira de especificar condições para sua busca, e elas podem ser muito complexas, e igualmente poderosas. Se não estiver familiarizado com expressões regulares, você pode escolher Editar para abrir o &kregexpeditor;. Esta ferramenta permitirá que você construa seu conjunto de condições graficamente, e então irá gerar a expressão para você.

  O &kregexpeditor; é uma ferramenta muito útil, e pode ser usado a partir de diversos aplicativos &kde; além do &kfind;. Você pode encontrar mais informações sobre ele em seu arquivo de ajuda.

Incluir arquivos binários

- Isto permite que você pesquise em qualquer tipo de arquivo, até mesmo aqueles que normalmente não contém texto (por exemplo, arquivos de programas e imagens).

### A Aba Propriedades

Aqui você pode refinar sua busca. Existem os seguintes refinamentos especiais que você pode escolher:

Procurar todos os arquivos criados ou modificados

- Aqui você pode inserir duas datas, entre as quais os arquivos foram criados ou modificados, ou especificar um período de tempo.

O tamanho do arquivo é

- Aqui você pode especificar se o arquivo precisa ter no mínimo ou no máximo o valor indicado no campo seguinte, ou ainda ter o tamanho igual.

Arquivos pertencentes ao usuário, Arquivos pertencentes ao grupo

- Aqui você pode indicar nomes de usuário e grupo dos arquivos.

## Créditos e Licença

&kfind;

Direitos autorais do programa:

## Desenvolvedores

- Martin Hartig

- &Stephan.Kulow; &Stephan.Kulow.mail;

- &Mario.Weilguni; &Mario.Weilguni.mail;

- &Alex.Zepeda; jazepeda@pacbell.net

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

- &Harri.Porten; &Harri.Porten.mail;

- Dima Rogozin dima@mercury.co.il

- &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;

- Hans Petter Bieker bieker@kde.org

- &Waldo.Bastian; &Waldo.Bastian.mail;

Direito de cópia da documentação 2001 &Dirk.Doerflinger;&Dirk.Doerflinger.mail;

Tradução de Marcus Gama marcus.gama@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &kfind;

&install.intro.documentation;

### Requisitos

Para usar com sucesso o &kfind; você precisa do &kde; 4.x.

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

&install.compile.documentation;
&documentation.index;