# O manual do &kfilereplace;

Emiliano
Gulmini

    emi_barbarossa@yahoo.it

Marcus
Gama

    marcus.gama@gmail.com

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

### 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, 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 . 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 do shell, criador do KPart, co-manutenedor

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

### 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:/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 anteror, mas sem raiz inicial. devolve o resultado de uma expressão matemática do &bc; v1.06.

&documentation.index;