# Manual do &kfilereplace;

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

Personalizar sessão de Procurar/Substituir

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

Procurar

- Este botão inicia um ciclo de busca.

Simular

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

Substituir

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

Parar

- Este botão para a operação.

Adicionar texto

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

Apagar texto

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

Editar texto selecionado

- Este botão edita um texto selecionado.

Limpar lista de textos

- Este botão exclui todos os textos na lista.

Inverter texto atual

- 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 a partir de um arquivo

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

Incluir subpastas

- Este botão permite realizar uma busca/substituição recursivamente nas subpastas 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.

Sensível à caixa

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

Ativar comandos no texto de substituição

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

Ativar 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 Procurar & Substituir na Janela de Arquivos

O diálogo de Procurar & Substituir em arquivos é 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 aba 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 Personalizar sessão de Procurar/Substituir. Então você deve inserir o caminho base e a sequência de curingas 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 aba 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).

### A janela de 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

Não mostrar os arquivos se nenhum texto for encontrado ou substituído Ao procurar, parar no primeiro texto encontrado Seguir ligações simbólicas Ignorar os arquivos e pastas ocultos
- mostra apenas os arquivos que correspondem a algum dos seus textos. Isto irá acelerar a procura. O &kfilereplace; irá parar, quando encontrar um texto correspondente, e continuará a pesquisa por outros textos ou, se procurar apenas por uma ocorrência, no próximo arquivo. se um arquivo for uma ligação para outro, então procura no arquivo real. se forem encontrados arquivos ou pastas ocultos, ignora-os.

### A janela para Inserir textos de procura/substituição

A janela de Inserir textos de procura/substituição do &kfilereplace; A janela de Inserir textos de procura/substituição 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, selecione 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 do 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 &RMB;. Irá aparecer um menu, a partir do qual você poderá abrir o arquivo.

### 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 do shell, criador do KPart e co-mantenedor

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@gmail.com

&underFDL; &underGPL;

## Instalação e compilação

&install.intro.documentation; &install.compile.documentation;

### 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:`/local/pasta/meu-arquivo`$] [$empty:$] [$random:`UM_NUMERO_INTEIRO`$] [$random:$] [$mathexp:`expressão-do-bc`$]
- este comando devolve a data e hora atuais no formato ISO do &Qt;. como o anterior, mas no formato local. devolve o UID do usuário atual. devolve o GID do usuário atual. devolve o nome do usuário atual. devolve o nome completo do usuário atual. devolve a pasta pessoal do usuário atual. devolve a linha de comando do usuário atual. devolve o conteúdo do arquivo meu-arquivo. devolve um texto vazio. devolve um número aleatório, usando o UM_NUMERO_INTEIRO como raiz inicial dos números aleatórios. como o anterior, mas sem raiz inicial. devolve o resultado de uma expressão matemática do &bc; v1.06.

&documentation.index;