Copyright © 2004 Emiliano Gulmini
É dada permissão para copiar, distribuir e/ou modificar este documento ao abrigo da GNU Free Documentation License, Versão 1.1 ou de uma versão mais recente publicada pela Free Software Foundation; sem Secções Invariantes, sem Textos de Capa Frontal, e sem Textos de Capa Traseira. Uma cópia desta licença está incluida na secção intitulada "GNU Free Documentation License".
O KFileReplace é utilitário para procurar e substituir texto.
Índice
O KFileReplace é uma aplicação que efectua procuras e substituições de texto num ou mais ficheiros. Os textos que deseja procurar poderão ser literais ou expressões regulares do Qt™. Existem ainda outras opções que poderá usar para afinar a sua procura.
A barra de ferramentas do KFileReplace tem este aspecto:
A barra de ferramentas mostra-lhe os botões com as funcionalidades principais.
Ícones da Barra de Ferramentas
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.
Este botão inicia um ciclo de procura.
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.
Este botão inicia um ciclo de procura e substituição simulada. Não irá acontecer nada, de facto, quando carregar neste botão.
Este botão interrompe uma operação.
Este botão abre uma janela para Adicionar Textos, na qual poderá editar a sua lista de textos.
Este botão remove o texto seleccionado (ou o actual, se não estiver nenhum seleccionado) da lista.
Este botão edita um determinado texto seleccionado.
Este botão remove todos os textos da lista.
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.
Este botão carrega uma lista de textos gravada num ficheiro XML com a extensão kfr
.
Este botão permite-lhe procurar/substituir recursivamente nas subpastas da sua pasta de base.
Este botão activa a geração de ficheiros de cópias de segurança.
Este botão activa a procura num modo que faça a distinção entre maiúsculas e minúsculas.
Este botão activa a capacidade dos comandos. Os comandos são sequências de texto especiais. Veja a secção sobre os “Comandos”.
Este botão activa as expressões regulares do tipo do Qt™.
A área de Resultados mostra o nome dos ficheiros que contêm os textos que deve obter (e substituir), a sua localização, tamanho, número de textos encontrados e o nome do utilizador dos ficheiros. Esta área mostra também a posição exacta dos textos correspondentes. Poderá também abrir um ficheiro se carregar nele com o botão do rato na lista que contém a posição da linha e coluna.
Esta é a área de Textos:
A área de Textos mostra a lista de palavras que deseja procurar/substituir. Lembre-se que o KFileReplace, no modo de procura, a área de Resultados e de Textos têm uma disposição diferente.
A janela de Nova sessão é usada para configurar os parâmetros básicos que são necessários para o KFileReplace funcionar. Consiste em duas páginas: a página Geral e a Avançado.
Quando você quiser iniciar uma nova sessão, o primeiro passo é carregar no botão de Nova Sessão. Depois, terá de indicar a pasta de base e uma sequência de caracteres especiais do tipo da consola (p.ex., * e ?) a usar como filtro.
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 [1], 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 , caso contrário deixe o campo de procura vazio e carregue em .
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).
[1] Repare por favor que as expressões regulares e os comandos poderão reduzir a velocidade de execução.
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 -> do menu.
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 .
Este capítulo oferece algumas informações sobre algumas capacidades úteis do KFileReplace.
Quando desejar reutilizar uma lista com os textos, poderá gravá-la num ficheiro XML
. Para o fazer, seleccione no menu a opção ->->. 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 ->->. O formato actual deste ficheiro é:
<?xml version="1.0" ?> <kfr> <mode search="false"/> <replacement> <oldstring ><![CDATA[TEXTO_PROCURA_1]] ></oldstring> <newstring ><![CDATA[TEXTO_SUBSTITUICAO_1]] ></newstring> </replacement> <replacement> <oldstring ><![CDATA[TEXTO_PROCURA_2]] ></oldstring> <newstring ><![CDATA[TEXTO_SUBSTITUICAO_2]] ></newstring> </replacement> <replacement> <oldstring ><![CDATA[TEXTO_PROCURA_N]] ></oldstring> <newstring ><![CDATA[TEXTO_SUBSTITUICAO_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.
Poderá criar um relatório se escolher a opção ->-> 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.
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 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”.
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 . Se quiser personalizar a extensão dos ficheiros de cópias de segurança, abra a janela de opções.
Se quiser abrir um ficheiro que corresponda a algum dos seus textos, deverá seleccionar uma linha da janela do resultado e carregar nela com o botão KFileReplace incorporado no Quanta Plus, poderá abrir directamente o ficheiro nele, na linha e coluna indicadas.
do rato. Irá aparecer um menu, onde depois só terá de seleccionar uma opção dele. Lembre-se que, se usar oSuponha 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.
KFileReplace. Programa copyright 1999 por François Dupoux (dupoux AT dupoux.com)
, 2003 Andras Mantia (amantia AT kde.org)
, 2004 Gulmini Emiliano (emi_barbarossa AT yahoo.it)
Os autores e equipa de manutenção 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 actual, limpeza e reescrita de código
Documentação copyright (c) 2004 Emiliano Gulmini (emi_barbarossa AT yahoo.it)
Tradução de Pedro Morais (morais AT kde.org)
A documentação está licenciada ao abrigo da GNU Free Documentation License.
Este programa está licenciado ao abrigo da GNU General Public License.
O KFileReplace faz actualmente parte da ferramenta kdewebdev, como tal, para o instalar, terá de obter uma cópia do kdewebdev. Lembre-se que, se estiver a usar uma instalação do KDE oferecida pelo seu distribuidor do SO, provavelmente já terá o kdewebdev instalado, pelo que neste caso poderá usar o KFileReplace ao abrir o editor Web Quanta plus ou invocando-o directamente. Caso contrário, poderá obter o pacote kdewebdev a partir da Internet; baseie-se na página pessoal do kdewebdev para mais informações.
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).
/local/pasta/o-meu-ficheiro
$]: devolve o conteúdo do ficheiro meu-ficheiro.UM_NUMERO_INTEIRO
$]: devolve um número aleatório, usando o UM_NUMERO_INTEIRO como raiz inicial dos números aleatórios.expressão-do-bc
$]: devolve o resultado de uma expressão matemática do bc v1.06.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team