# Manual do &kfilereplace;

Emiliano
Gulmini

    emi_barbarossa@yahoo.it

Marcus
Gama

    marcus_gama@uol.com.br

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

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

KDE
KFileReplace
substituir
procurar
texto

## Introdução

O &kfilereplace; é um aplicativo que realiza busca e substituição de um ou mais textos em um ou mais arquivos. O texto para procura podem ser literais ou expressões regulares no estilo QT. Existe um conjunto de opções que podem ser usada para ajustar sua busca.

## Usando o &kfilereplace;

Aqui está uma imagem do &kfilereplace; em sua apresentação de aplicativo separado Imagem

### A Barra de Ferramentas

The KFileReplace toolbar should looks like this: Aqui está uma imagem do &kfilereplace; Imagem

A barra de ferramentas permite selecionar as principais funcionalidades. Por exemplo, se você deseja procurar por textos você deve adicioná-los na visão inferior. Assim, para fazer isto você clica no botão "+" e um diálogo aparecerá permitindo que você insira seu texto. Vamos explicar a funcionalidade de cada ícone na barra de ferramentas:

#### Ícones da barra de ferramentas

Diálogo de nova sessão

  This button shows a session dialog window in wich you can set several basic options, if KFileReplace run as standalone application you should click this button as first step.

Botão somente de procura

  Este botão inicia um ciclo de busca.

Botão de substituição

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

Botão de substituição simulada

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

Botão de parar

  Este botão para a busca.

Botão de adicionar textos

  This button opens the Add strings dialog in which you can edit your strings list..

Botão de apagar textos

  Este botão cancela um texto da lista.

Botão de editar textos

  Este botão edita um texto selecionado.

Botão de apagar lista

  Sem imagem Este botão exclui todos os textos na lista.

Botão de inverter textos

  Este botão alterna o texto procurado com o texto de substituição. Assim você pode reverter um ciclo de busca/substituição.

Botão de carregar lista de textos

  This button loads a strings list.

Botão de procurar nas sub-pastas

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

Botão para criar arquivos de cópia de segurança

  Este botão habilita a geração de arquivos de cópia de segurança. Seus arquivos originais terão o mesmo nome, mas outra extensão.

Botão de procura sensível à caixa

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

Botão de comandos

  This button enables commands capability. Commands are special replace strings. Say for example that you want substitute the word "date" with the actual date string in ISO format, then you should insert in your list "date" as search string and " [$datetime:local$]" as replace string. See Commands section.

Botão de expressões regulares

  Este botão habilita as expressões regulares no estilo QT. Se você deseja procurar os textos "xml", "html" e "uml", você pode escrever a linha "(x|h|u)ml" na coluna de busca da lista.

### A Lista de Resultados

Esta é a visão dos resultados: Aqui está uma imagem do &kfilereplace; Imagem

A visão dos resultados mostra o nome dos arquivos que contém os textos que você pesquisou(e substituiu). Esta visão também fornece a posição exata do texto correspondente.

### A Lista de Textos

Esta é a visão de textos: Aqui está uma imagem do &kfilereplace; Imagem

The strings view visualizes the list of words you want search/replace. Please not that in search mode the results view and the strings view have a different layout.

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

Esta é a página "Geral": Aqui está uma imagem do &kfilereplace; Imagem

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 shell-like wildcards sequence to use as filter. Here's a screenshot of &kfilereplace; Screenshot Then you could set some usefull options, like searching in all the sub folders, doing a case sensitive search, enabling commands and/or regular expressions(please note that regular expressions and commands could slow down the speed performances!), doing a backup copy of each file that KFileReplace should modify. Here's a screenshot of &kfilereplace; Screenshot Finally if you wish to start now then put a string in the search line edit widget and press "Search now" button, otherwise live the line edit widgets empty and press "Search later" button. Aqui está uma imagem do &kfilereplace; Imagem

#### A Página Avançado

Esta é a página "Avançado": Aqui está uma imagem do &kfilereplace; Imagem

The Advanced Page allows you to set up some usefull options to restrict search to subset of your target tree. If you want execute KFileReplace only over files that have dimensions in the range of 10KB - 100KB then you could use the size options. Here's a screenshot of &kfilereplace; Screenshot Date option, restrict the search in a temporal range. Here's a screenshot of &kfilereplace; Screenshot This last option, allows you to only search for files owned (or not owned) by a particular user. Actually this could be more usefull to the system administrators. Aqui está uma imagem do &kfilereplace; Imagem

### The Options Dialog

This dialog contains options that are in the toolbar and extra options, that may come in handy in some situation. You can invoke it selecting "Settings | Configure KFileReplace" in the menu.

#### General options

These options have been presented in the Toolbar section, so go to the advanced options. Aqui está uma imagem do &kfilereplace; Imagem

#### Advanced options

Aqui está uma imagem do &kfilereplace; Imagem

- Do not show files if no strings are found or replaced - lets you to visualize only the files that match with some of your strings. This will speed up the search.

- When searching, stop on firts string found - KFileReplace will stop when match a string, and will continue to search for other strings or, if you only search for one string, it will continue with the next file.

- Follow symbolic links - if a file is a link to another one, then search in the real file.

- Ignore hidden files and directories - well need to be explained?.

### The Add Strings Dialog

Aqui está uma imagem do &kfilereplace; Imagem This dialog is used to insert and edit a list of strings. It is simple to use, you only must choose wheter to insert a search-only list or a search-and-replace list, then with the two mini editors you will introduce your texts. The arrow buttons, allow you to add a pair of strings or delete it if you think you made a mystake.

## Recursos do KFileReplace

This chapter provides informations about the main capabilities of 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 é: Aqui está uma imagem do &kfilereplace; Imagem

se você estiver usando um formato anterior você pode atualizar seu arquivo simplesmente adequando-o ao esquema acima.

### How to create a simple report

You can create a report by choosing "Search/Replace | Results | Create Report File" from the menu. A report is a directory containing an xml file and a css file. Look the picture Aqui está uma imagem do &kfilereplace; Imagem

### Comandos

Suppose you want subtitute the phrase "Alice's adventures in wonderland" with the entire file that contains Carroll's novel. Probably you don't want to do this by hand, what you need is a "command" that do it for you. So click the add button, select "search and replace mode" and insert the following strings: "Alice's adventure in wonderland" in the search mini editor and the string [$loadfile:/the-path-to-my-directory/my-directory/my-file$] in the replace mini editor. Click Ok button, and when you come back to KFileReplace main window, toggle the command action button that enables the commands, and start the replace. Other commands are presents, please see Appendix B for a list of available commands.

## Créditos e Licença

Direitos autorais do programa &kfilereplace; 1999 by François Dupoux dupoux@dupoux.com 2003 Andras Mantia amantia@kde.org 2004 Gulmini Emiliano 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 Gulmini Emiliano emi_barbarossa@yahoo.it

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

&underFDL; &underGPL;

## Instalação

### How to install KFileReplace

KFileReplace is actually part of Kdewebdev tool, so to in order to install it, you must obtain 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 Quanta plus web editor or by calling it directly. If not you can download Kdewebdev package from the internet, please refer to Kdewebdev home site for more informations.

http://kde-apps.org

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

## KFileReplace commands

[$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 actual date and time in QT ISO format. like above but in local format. return the UID of the actual user. return the GID of the actual user. return the login name of the actual user. return the full name of the actual user. return the home directory of the actual user. return the shell of the actual user. return the content of the my-file file. return the empty string. return a random number string using AN_INTEGER_NUMBER like initial seed. like above, but without initial seed. return the result of a bc v1.06 mathematical expression.

&documentation.index;