# Manual do &kfilereplace;

Emiliano Gulmini

    emi_barbarossa@yahoo.it

Marcus Gama

    marcus_gama@uol.com.br

Tradução
2004 Emiliano Gulmini
&FDLNotice;
2004-08-09
1.0.0

O &kfilereplace; é um utilitário para procurar e substituir textos.

KDE KFileReplace substituir procurar texto

## Introdução

O &kfilereplace; é um aplicativo usado para buscar e substituir uma lista de textos em uma árvore de arquivos. O texto pode ser literal ou expressões regulares no estilo &qt;. Existe também um conjunto de outras opções que podem ser usadas para ajustar sua busca.

## Usando o &kfilereplace;

O &kfilereplace; em sua apresentação de aplicativo separado

O &kfilereplace; em sua apresentação de aplicativo separado

### A Barra de Ferramentas

A barra de ferramentas do &kfilereplace; se parece com isto: Barra de ferramentas do &kfilereplace;

Barra de ferramentas do &kfilereplace;

A barra de ferramentas lhe mostra os botões com as funcionalidades principais.

Ícones da Barra de Ferramentas

Nova sessão

  Este botão mostra um diálogo de sessão no qual você pode configurar as diversas opções básicas. Se o &kfilereplace; for rodado como aplicativo separado você deve clicar neste botão como primeiro passo.

Somente procurar

  Este botão inicia um ciclo de busca.

Substituir

  Este botão inicia um ciclo de busca&substituição. Quando um texto for encontrado o &kfilereplace; o substituirá com outro texto.

Substituição Simulada

  Este botão inicia um ciclo simulado de busca&substituição. Nada acontecerá realmente quando você clicar neste botão.

Parar

  Este botão para a operação.

Adicionar Textos

  Este botão abre o diálogo Adicionar Textos no qual você pode editar sua lista de textos.

Apagar Textos

  Este botão remove um texto selecionado (ou o atual se nenhum estiver selecionado) da lista.

Editar Textos

  Este botão edita um texto selecionado.

Apagar Lista

  Este botão exclui todos os textos na lista.

Inverter Textos

  Este botão alterna o texto procurado com o texto de substituição, de modo que você possa reverter uma operação de busca/substituição.

Carregar Lista de Textos

  Este botão carrega uma lista de textos gravada num arquivo XML com uma extensão `kfr`.

Procurar nas Sub-pastas

  Este botão permite realizar uma busca/substituição recursivamente nas sub-pastas de seu diretório base.

Criar Arquivos de Cópia de Segurança

  Este botão ativa a geração de arquivos de cópias de segurança.

Procura Sensível à Caixa

  Este botão habilita a procura sensível à caixa (distinguindo maiúsculas de minúsculas).

Comandos

  Este botão ativa a capacidade dos comandos. Os comandos são sequências de texto especiais. Veja .

Expressões regulares

  Este botão ativa as expressões regulares estilo &qt;.

### A Lista de Resultados

Visão de Resultados do &kfilereplace;
Visão de Resultados do &kfilereplace;

A visão dos Resultados mostra o nome dos arquivos que contém os textos que você pesquisou (e substituiu), seu caminho, seu tamanho, o número de textos encontrados e a id do usuário dos arquivos. Esta visão também fornece a posição exata do texto correspondente. Você pode também abrir um arquivo clicando com o &RMB; na entrada da lista que contém a posição da linha e coluna.

### A Lista de Textos

Esta é a visão de Textos: Visão de Textos do &kfilereplace;

Visão de Textos do &kfilereplace;

A visão de Textos visualiza a lista de palavras que você deseja procurar/substituir. Por favor observe que no modo de procura os visão dos Resultados e a visão dos Textos possuem uma disposição diferente.

### O Diálogo Nova Sessão

O diálogo de Nova Sessão é usado para configurar os parâmetros básicos necessários para fazer com que o &kfilereplace; funcione. Ele consiste de duas páginas: a Geral e a Avançado.

#### A Página Geral

Página Geral do &kfilereplace;
Página Geral &kfilereplace;

Quando você deseja iniciar uma nova sessão o primeiro passo é clicar no botão Nova Sessão. Então você deve inserir o caminho base e a sequência de coringas do shell a usar como filtro.

Então você pode configurar algumas opções úteis, como procurar em todas as subpastas, fazer uma procura sensível à caixa, habilitar comandos e/ou expressões regulares

Por favor observe que expressões regulares e comandos podem diminuir o desempenho da operação.

, fazer uma cópia de segurança para cada arquivo antes de substituir.

Se você deseja iniciar a procura, você pode inserir um texto na caixa de procura e pressionar o Procurar Agora, caso contrário deixe a caixa de procura vazia e pressione Procurar Depois.

#### A Página Avançado

A página Avançado do &kfilereplace;
A página Avançado do &kfilereplace;

A página Avançado permite que você configure algumas opções úteis para restringir a procura a um sub-conjunto da sua árvore de arquivos alvo. Se você deseja rodar o &kfilereplace; somente em arquivos que possuam um tamanho num intervalo de 10KB - 100KB, então você pode usar estas opções de tamanho. Existe também uma opção de data que restringe a procura num intervalo de tempo, e uma última opção que permite que você procure somente arquivos cujo dono seja (ou não) um determinado usuário (isto pode ser mais útil para administradores de sistemas).

### O Diálogo Opções

Este diálogo contém as opções que estão na barra de ferramentas e as opções extra que poderão ser úteis em algumas situações. Você poderá invocá-la com a opção Configurações Configurar o KFileReplace... do menu principal.

#### Opções gerais

Estas opções foram apresentadas na seção da Barra de Ferramentas. A janela de Opções da página Geral

A janela de Opções da página Geral

#### Opções avançadas

A janela de Opções da página Avançado

A janela de Opções da página Avançado

Do not show files if no strings are found or replaced When searching, stop on first string found Follow symbolic links Ignore hidden files and directories
- shows only the files that match some of your strings. This will speed up the search. &kfilereplace; will stop when it finds a matching string, and will continue to search for other strings or, if you search for only one string, it will continue with the next file. if a file is a link to another one, then search in the real file. if hidden files or folders are encountered, ignore them.

### O Diálogo Adicionar Textos

O diálogo Adicionar Textos do &kfilereplace;
O diálogo Adicionar Textos do &kfilereplace;

Este diálogo é usado para inserir e editar uma lista de textos. Você só precisa inserir uma lista apenas para procura ou uma lista para procura-e-substituição, e então como os dois mini-editores inserir seus textos. Os botões das setas permitem-lhe adicionar um par de textos ou removê-los. Quando tiver terminado, clique no botão Ok.

## Recursos do &kfilereplace;

Este capítulo fornece informações sobre alguns recursos úteis do &kfilereplace;.

### Como salvar a sua lista de textos

Quando você desejar reutilizar uma lista de textos você pode salvá-la em um arquivo `xml`. Para fazer isso, seleciona na barra de menu a opção Procurar/Substituir Textos Salvar Lista de Textos para Arquivo. Quando você salvar uma lista, um arquivo único `xml` com extensão `kfr` é criado. Para carregar um arquivo `kfr`, selecione a partir da barra de menu Procurar/Substituir Textos Carregar Lista de Textos de Arquivo. O formato atual do arquivo é:

    <?xml version="1.0" ?>
    <kfr>
            <mode search="false"/>
            <replacement>
                    <textoantigo
    ><![CDATA[SEARCH_STRING_1]]
    ></textoantigo>
                    <textonovo
    ><![CDATA[REPLACE_STRING_1]]
    ></textonovo>
            </replacement>
            <replacement>
                    <textoantigo
    ><![CDATA[SEARCH_STRING_2]]
    ></textoantigo>
                    <textonovo
    ><![CDATA[REPLACE_STRING_2]]
    ></textonovo>
            </replacement>

            <replacement>
                    <textoantigo
    ><![CDATA[SEARCH_STRING_N]]
    ></textoantigo>
                    <textonovo
    ><![CDATA[REPLACE_STRING_N]]
    ></textonovo>
            </replacement>

    </kfr
    >

Se estiver usando um formato anterior, poderá atualizar manualmente o seu arquivo, modificando-o de acordo com o esquema acima descrito. Em alternativa, poderá carregar o arquivo no formato antigo e salvá-lo novamente com o &kfilereplace;, tal como foi descrito anteriormente.

### Como Criar um Relatório Simples

Você poderá criar um relatório se escolher a opção Procurar/Substituir Resultados Criar um Arquivo de Relatório do menu. Um relatório é uma pasta que contém um arquivo `xml` e um arquivo `css`. Os relatórios poderão ser úteis, se pretende manter um sistema de registro das suas operações. Recurso de Relatório do &kfilereplace;

Recurso de Relatório do &kfilereplace;

### Como usar Expressões Regulares

Se você quiser procurar por todos os textos que comecem por x ou ht ou u e terminem em ml, poderá inserir uma expressão regular do tipo `(x|ht|u)ml`. Insira esta expressão no editor de procura, clique no botão OK, e ative as expressões regulares alternando o botão Expressão Regular. Por favor, lembre-se que a utilização de expressões regulares permite-lhe fazer pesquisas muito complexas, mas o custo poderá ser uma degradação da velocidade. A expressão regular pode ser um bom truque, e ela frequentemente faz com que se você deseja resolver um problema com uma expressão regular, você tem dois problemas.

### Como Proteger os Arquivos Originais

Se você não quiser perder os seus arquivos originais, você poderá fazer uma cópia deles antes de fazer as substituições de texto. Após inserir os seus textos e, antes de iniciar a substituição, assinale o botão de Cópia de segurança. Se quiser personalizar a extensão dos arquivos de cópias de segurança, abra o diálogo de Opções.

### Como Abrir um Arquivo

Se quiser abrir um arquivo que corresponda a algum dos seus textos, você deverá selecionar uma linha da janela do resultado e clicar nela com o . Irá aparecer um menu,&RMB; a partir do qual você poderá abrir o arquivo. Lembre-se que, se usar o &kfilereplace; incorporado no &quantaplus;, você poderá abrir diretamente o arquivo nele, na linha e coluna indicadas.

### Comandos

Suponhamos que você queira substituir a frase Alice no país das maravilhas como o arquivo inteiro que contém o romance de Carroll. Provavelmente você não deseja fazer isto manualmente, assim tudo o que precisa é um comando que faça isto para você. Assim, clique o botão Adicionar, selecione Modo Procurar e Substituir e insira os seguintes textos: `Alice no país das maravilhas` no mini-editor de procura e o texto `[$loadfile:/caminho/meuarquivo$]` no mini-editor de substituição. Clique no botão Ok. Quando retornar à janela principal do &kfilereplace; alterne o botão Comando de ação que habilita os comandos, e inicie a substituição. Outros comandos estão disponíveis, por favor veja o Apêndice B para uma lista de comandos disponíveis.

## Créditos e Licença

Direitos autorais do programa &kfilereplace; de François Dupoux dupoux@dupoux.com, 2003 Andras Mantia amantia@kde.org, 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

Os autores e mantenedores do &kfilereplace;:

François Dupoux dupoux@dupoux.com

  Autor original

Andras Mantia amantia@kde.org

  Autor da 'shell', criador da KPart, co-manutenção

Emiliano Gulmini emi_barbarossa@yahoo.it

  Manutenção atual, limpeza & reescrita de código

Direitos autorais da documentação 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

Tradução de Marcus Gamamarcus_gama@uol.com.br

&underFDL; &underGPL;

## Instalação

### Como instalar o &kfilereplace;

O &kfilereplace; é atualmente parte do pacote &kdewebdev;, assim para instalá-lo, você deve obter uma cópio do &kdewebdev;. Observe que se você estiver usando uma instalação do &kde; fornecida por uma distribuição, provavelmente você já possui o &kdewebdev; instalado. Neste caso você pode usar o &kfilereplace; abrindo o editor web &quantaplus; ou chamando-o diretamente (a menos que você tenha uma versão antiga do &kde;). Se você não consegue transferir o pacote &kdewebdev; da internet, por favor acesse a página pessoal do &kdewebdev; para mais informações.

### Requisitos

Para usar o comando [$mathexp:expressao_matematica$] você deve instalar o utilitário matemático &bc; (versão 1.06 ou superior) escrito por Philip A. Nelson(philnelson@acm.org).

## Comandos do &kfilereplace;

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:/my-path/my-directory/my-file$] [$empty:$] [$random:AN_INTEGER_NUMBER$] [$random:$] [$mathexp:bc-expression$]
- this command return the current date and time in &qt; ISO format. like above but in local format. return the UID of the current user. return the GID of the current user. return the login name of the current user. return the full name of the current user. return the home directory of the current user. return the shell of the current user. return the content of the my-file file. return the empty string. return a random number string using AN_INTEGER_NUMBER as the initial seed. like above, but without initial seed. return the result of a &bc; v1.06 mathematical expression.

&documentation.index;