Copyright © 2004 Emiliano Gulmini
É concedida permissão para copiar, distribuir e/ou modificar este documento sob os termos da Licença de Documentação Livre GNU, Versão 1.1 ou qualquer versão posterior publicada pela Fundação do Software Livre; com nenhuma Seção Não Modificável, com nenhum Texto de Capa, e com nenhum Texto de Contra-Capa. Uma cópia da licença está incluída na seção intitulada "Licença de Documentação Livre GNU".
O KFileReplace é um utilitário para procurar e substituir textos.
Índice
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.
A barra de ferramentas do KFileReplace se parece com isto:
A barra de ferramentas lhe mostra os botões com as funcionalidades principais.
Ícones da Barra de Ferramentas
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.
Este botão inicia um ciclo de busca.
Este botão inicia um ciclo de busca&substituição. Quando um texto for encontrado o KFileReplace o substituirá com outro texto.
Este botão inicia um ciclo simulado de busca&substituição. Nada acontecerá realmente quando você clicar neste botão.
Este botão para a operação.
Este botão abre o diálogo Adicionar Textos no qual você pode editar sua lista de textos.
Este botão remove um texto selecionado (ou o atual se nenhum estiver selecionado) da lista.
Este botão edita um texto selecionado.
Este botão exclui todos os textos na lista.
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.
Este botão carrega uma lista de textos gravada num arquivo XML com uma extensão kfr
.
Este botão permite realizar uma busca/substituição recursivamente nas sub-pastas de seu diretório base.
Este botão ativa a geração de arquivos de cópias de segurança.
Este botão habilita a procura sensível à caixa (distinguindo maiúsculas de minúsculas).
Este botão ativa a capacidade dos comandos. Os comandos são sequências de texto especiais. Veja “Comandos”.
Este botão ativa as expressões regulares estilo Qt.
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 botão do mouse na entrada da lista que contém a posição da linha e coluna.
Esta é a visão de Textos:
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 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.
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[1], 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 , caso contrário deixe a caixa de procura vazia e pressione .
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).
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 -> do menu principal.
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 .
Este capítulo fornece informações sobre alguns recursos úteis do KFileReplace.
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 ->->. 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 ->->. 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.
Você poderá criar um relatório se escolher a opção ->-> 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.
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 , e ative as expressões regulares alternando o botão . 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”.
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.
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,botão KFileReplace incorporado no Quanta Plus, você poderá abrir diretamente o arquivo nele, na linha e coluna indicadas.
do mouse a partir do qual você poderá abrir o arquivo. Lembre-se que, se usar oSuponhamos 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:
no mini-editor de substituição. Clique no botão . 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./caminho/meuarquivo
$]
Direitos autorais do programa KFileReplace de François Dupoux (dupoux AT dupoux.com)
, 2003 Andras Mantia (amantia AT kde.org)
, 2004 Emiliano Gulmini (emi_barbarossa AT yahoo.it)
Os autores e mantenedores do KFileReplace:
(dupoux AT dupoux.com)
Autor original
(amantia AT kde.org)
Autor da 'shell', criador da KPart, co-manutenção
(emi_barbarossa AT yahoo.it)
Manutenção atual, limpeza & reescrita de código
Direitos autorais da documentação 2004 Emiliano Gulmini (emi_barbarossa AT yahoo.it)
Tradução de Marcus Gama(marcus_gama AT uol.com.br)
Esta documentação é licenciada sob os termos da Licença de Documentação Livre GNU.
Este programa é licenciado sob os termos da Licença Pública Geral GNU.
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 Quanta Plus 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.
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 AT acm.org)
).
/my-path/my-directory/my-file
$]: return the content of the my-file file.AN_INTEGER_NUMBER
$]: return a random number string using AN_INTEGER_NUMBER as the initial seed.bc-expression
$]: return the result of a bc v1.06 mathematical expression.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team