# Manual do &kfilereplace;

## Introdução

&kfilereplace; is an application used to search and replace a list of strings in a file tree. The strings may be literal or &qt;-like regular expressions. There are also other options to tune your search.

## Utilizar o &kfilereplace;

O &kfilereplace; na sua versão independente O &kfilereplace; na sua versão independente

### A Barra de Ferramentas

A barra de ferramentas do &kfilereplace; tem este aspecto: A barra de ferramentas do &kfilereplace; A barra de ferramentas do &kfilereplace;

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

### Ícones da Barra de Ferramentas

New session

- Este botão mostra uma janela de sessão, na qual poderá definir várias opções básicas; se o &kfilereplace; correr como uma aplicação autónoma, deverá carregar neste botão como primeiro passo.

Search only

- Este botão inicia um ciclo de procura.

Substituir

- Este botão inicia um ciclo de procura e substituição. Quando for encontrada uma determinada sequência de texto, o &kfilereplace; substitui-la-á por outro texto.

Simulated Replace

- Este botão inicia um ciclo de procura e substituição simulada. Não irá acontecer nada, de facto, quando carregar neste botão.

Parar

- Este botão interrompe uma operação.

Add Strings

- Este botão abre uma janela para Adicionar Textos, na qual poderá editar a sua lista de textos.

Delete Strings

- Este botão remove o texto seleccionado (ou o actual, se não estiver nenhum seleccionado) da lista.

Edit Strings

- Este botão edita um determinado texto seleccionado.

Delete List

- Este botão remove todos os textos da lista.

Invert Strings

- Este botão troca um determinado texto de procura pelo seu texto de substituição; deste modo, poderá inverter o ciclo de procura/substituição.

Load String List

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

Search in Subfolders

- Este botão permite-lhe procurar/substituir recursivamente nas subpastas da sua pasta de base.

Make Backup Files

- Este botão activa a geração de ficheiros de cópias de segurança.

Case-sensitive Search

- Este botão activa a procura num modo que faça a distinção entre maiúsculas e minúsculas.

Commands

- Este botão activa a capacidade dos comandos. Os comandos são sequências de texto especiais. Veja a secção sobre os kfilereplace-commands.

Regular expressions

- This button enables &qt;-like regular expressions.

### A Lista de Resultados

Área de resultados do &kfilereplace; Área de resultados do &kfilereplace;

The Results view shows the name of the files that contain the strings you have to retrieve (and replace), their path, their size, the number of strings found and the user id of the files. This view also provides the exact position of each match. You can also open a file by clicking with the &RMB; on an list entry that contains line and column position.

### A Lista de Textos

This is the Strings view: Área de textos do &kfilereplace; Área de textos do &kfilereplace;

The Strings view visualizes the list of strings you want search/replace. Please note that in search mode the Results view and the Strings view have a different layout.

### The New Session Dialog

The New Session dialog is used to setup the basic parameters needed by &kfilereplace; to work. It consists of two tabs, General and Advanced.

#### The General Tab

A página Geral do &kfilereplace; A página Geral do &kfilereplace;

When you want to begin a new session the first step is to click on the New Session button. Then you must enter the base path and a sequence of shell-like wildcards to use as filter.

Depois, poderá definir algumas opções úteis, como a procura em todas as subpastas, fazer uma pesquisa com distinção entre maiúsculas e minúsculas, a activação de comandos e/ou expressões regulares

Repare por favor que as expressões regulares e os comandos poderão reduzir a velocidade de execução.

, fazendo uma cópia de segurança de cada ficheiro antes da substituição.

Se quiser iniciar a procura, poderá colocar um texto no campo de procura e carregar em Procurar Agora, caso contrário deixe o campo de procura vazio e carregue em Procurar Mais Tarde.

#### The Advanced Tab

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

A página Avançado permite-lhe configurar algumas opções úteis para restringir a procura a um sub-conjunto da sua árvore de ficheiros de alvo. Se quiser executar o &kfilereplace; apenas sobre os ficheiros que tiverem um tamanho entre 10KB - 100KB, então poderá usar as opções de tamanho. Existe também uma opção de data que restringe a procura num intervalo temporal e uma última opção que lhe permite procurar apenas nos ficheiros que pertençam (ou não) a um dado utilizador (isto poderá ser mais útil para os administradores de sistemas).

### The Options Dialog

Esta janela contém as opções que estão na barra de ferramentas e as opções extra que poderão ser úteis para uma determinada situação. Poderá invocá-la com a opção Configuração Configurar o KFileReplace... do menu.

#### Opções gerais

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

#### Opções avançadas

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

Não mostrar os ficheiros se não forem encontrados ou substituídos textos Ao procurar, parar no primeiro texto encontrado Seguir as ligações simbólicas Ignorar os ficheiros e pastas escondidos
- mostra apenas os ficheiros 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 ficheiro. se um ficheiro for uma ligação para outro, então procura no ficheiro real. se forem encontrados ficheiros ou pastas escondidos, ignora-os.

### The Add Strings Dialog

&kfilereplace;'s Add Strings dialog &kfilereplace;'s Add Strings dialog

Esta janela é usada para inserir e editar uma lista de textos. É simples de usar, pelo que só precisa de escolher se deseja introduzir uma lista apenas para procuras ou uma lista para procura-e-substituição, introduzindo a partir daí os seus textos. Os botões das setas permitem-lhe adicionar um par de textos ou removê-lo, se concluir que cometeu algum erro. Quando terminar, carregue no botão OK.

## Funcionalidades do &kfilereplace;

Este capítulo oferece algumas informações sobre determinadas capacidades úteis do &kfilereplace;.

### Como gravar a sua lista de textos

Quando desejar reutilizar uma lista com os textos, poderá gravá-la num ficheiro `XML`. Para o fazer, seleccione no menu a opção Procurar/Substituir Textos Gravar a Lista de Textos num Ficheiro. Quando gravar uma lista, será criado um ficheiro simples em `XML` com a extensão `kfr`. Para carregar um ficheiro `kfr`, seleccione no menu a opção Procurar/Substituir Textos Carregar uma Lista de Textos do Ficheiro. O formato actual deste ficheiro é:

    <?xml version="1.0" ?>
    <kfr>
            <mode search="false"/>
            <replacement>
                    <oldstring
    ><![CDATA[TEXTO_PROCURA_1]]
    ></oldstring>
                    <newstring
    ><![CDATA[TEXTO_SUBSTITUIÇÃO_1]]
    ></newstring>
            </replacement>
            <replacement>
                    <oldstring
    ><![CDATA[TEXTO_PROCURA_2]]
    ></oldstring>
                    <newstring
    ><![CDATA[TEXTO_SUBSTITUIÇÃO_2]]
    ></newstring>
            </replacement>

            <replacement>
                    <oldstring
    ><![CDATA[TEXTO_PROCURA_N]]
    ></oldstring>
                    <newstring
    ><![CDATA[TEXTO_SUBSTITUIÇÃO_N]]
    ></newstring>
            </replacement>

    </kfr
    >

Se estiver a usar um formato anterior, poderá actualizar à mão o seu ficheiro, tornando-o compatível com o esquema acima descrito. Em alternativa, poderá carregar o ficheiro no formato antigo e gravá-lo de novo com o &kfilereplace;, tal como está descrito anteriormente.

### Como Criar um Relatório Simples

Poderá criar um relatório se escolher a opção Procurar/Substituir Resultados Criar um Ficheiro de Relatório do menu. Um relatório é uma pasta que contém um ficheiro `XML` e um ficheiro `CSS`. Os relatórios poderão ser úteis, se pretender manter um sistema de registo das suas operações. Veja por favor a imagem. A funcionalidade de Relatório do &kfilereplace; A funcionalidade de Relatório do &kfilereplace;

### Como Usar as Expressões Regulares

Se quiser procurar por todos os textos que comecem por x ou ht ou u e terminem em ml, poderá indicar uma expressão regular do tipo `(x|ht|u)ml`. Introduza esta expressão no editor de procura, carregue no botão OK e, finalmente, active as expressões regulares com o botão de expressões regulares. Lembre-se que a utilização de expressões regulares permite-lhe fazer pesquisas muito complicadas, mas o curto poderá ser uma degradação da velocidade. As expressões regulares poderão ser bastante complicadas e, normalmente, é o caso de se quiser resolver um problema com uma expressão regular, você tem dois problemas.

### Como Proteger os Ficheiros Originais

Se não quiser perder os seus ficheiros originais, poderá fazer uma cópia deles antes de fazer as substituições de texto. Só precisa de introduzir os seus textos e, antes de iniciar a substituição, assinalar o botão de Cópia de segurança. Se quiser personalizar a extensão dos ficheiros de cópias de segurança, abra a janela de opções.

### Como Abrir um Ficheiro

If you want to open a file that matches some of your strings, you have to select a line in the result view and click on it with the &RMB;. A context menu will appear from which you can open the file. If you use &kfilereplace; embedded in &quantaplus;, you can open the file directly in it at the specified line and column.

### Commands

Suponha que deseja substituir a frase "As aventuras de Alice no país das maravilhas" com o ficheiro inteiro que contém a obra de Carroll. Provavelmente, não o quererá fazer à mão, pelo que necessita aqui de um "comando" que o faça por si. Deste modo, carregue no botão adicionar, seleccione o "modo de procura e substituição" e introduza os seguintes textos: "As aventuras de Alice no país das maravilhas" no mini-editor de procura e o texto "[$loadfile:`/local-da-minha-pasta/minha-pasta/meu-ficheiro`$]" no mini-editor de substituição. Carregue no botão Ok; nessa altura, quando voltar à janela principal do &kfilereplace;, carregue no botão da acção de comando que activa os comandos, iniciando a substituição. Estão presentes outros comandos; veja por favor o Apêndice B para obter uma lista com os comandos disponíveis.

## Créditos e Licença

&kfilereplace;. Programa copyright 1999 por François Dupoux dupoux@dupoux.com, 2003 Andras Mantia amantia@kde.org, 2004 Gulmini Emiliano emi_barbarossa@yahoo.it

## Os autores e equipa de manutenção 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 actual, limpeza e reescrita de código

Documentação com 'copyright' 2004 de Emiliano Gulmini emi_barbarossa@yahoo.it

Tradução de Pedro Morais morais@kde.org

&underFDL; &underGPL;

## Installation

### How to install &kfilereplace;

&kfilereplace; is currently part of &kdewebdev; package, so, in order to install it, you have to get a copy of &kdewebdev;. Note that if you are using a &kde; installation provided by your OS vendor, probably you already have &kdewebdev; installed; in this case, you can use &kfilereplace; either by opening &quantaplus; Web editor, or by calling it directly (unless you have an old &kde; version). Else you can download the &kdewebdev; package from the Internet: please refer to &kdewebdev; home site for more information.

### Requisitos

Para poder usar o comando [$mathexp:`uma_expressao_matematica`$], deverá instalar o utilitário matemático 'bc' (versão 1.06 ou posterior), que é da autoria de 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/o-meu-ficheiro`$] [$empty:$] [$random:`UM_NUMERO_INTEIRO`$] [$random:$] [$mathexp:`expressão-do-bc`$]
- this command return the current date and time in &qt; ISO format. como o anterior, mas no formato local. devolve o UID do utilizador actual. devolve o GID do utilizador actual. devolve o nome do utilizador actual. devolve o nome completo do utilizador actual. devolve a pasta pessoal do utilizador actual. devolve a linha de comandos do utilizador actual. devolve o conteúdo do ficheiro meu-ficheiro. 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;