# 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).

Pesquisar seções de metainformação

- Esses dois campos podem ser usados para pesquisar nos comentários específicos dos arquivos ou metainfo.

  Aqui estão alguns dos principais casos:

  - Arquivos de vídeo (avi, mp4, &etc;): especifique algumas etiquetas (`Bitrate`, `Duração`, &etc;) e seus valores para encontrar itens que contenham os valores dos parâmetros especificados em seus metadados.

  - Imagens (png, jpeg, &etc;): especifique algumas etiquetas (`Largura`, `Altura`, &etc;) e seus valores para encontrar itens que contenham os valores dos parâmetros especificados em seus metadados.

  - Arquivos de áudio (mp3, flac, &etc;): especifique algumas etiquetas (`Título`, `Álbum`, &etc;) e seus valores para encontrar itens que contenham os valores dos parâmetros especificados em seus metadados.

  - Ebooks (epub, azw, fb2, &etc;): especifique algumas etiquetas (`Título`, `Autor`, &etc;) e seus valores para encontrar itens que contenham os valores dos parâmetros especificados em seus metadados.

  Se houver uma tradução das etiquetas em seu idioma você pode usar os nomes traduzidos das etiquetas nos critérios da pesquisa.

### 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;
&documentation.index;