Manual do KFileReplace
Manual do KFileReplace
Próximo

Manual do KFileReplace

Emiliano Gulmini

Tradução: Pedro Morais
Revisão 1.0.0 (2004-08-09)

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


Capítulo 1. Introdução
Introdução
Anterior
Próximo

Capítulo 1. Introdução

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.

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 2. Utilizar o KFileReplace
Utilizar o KFileReplace
Anterior
Próximo

Capítulo 2. Utilizar o KFileReplace


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 mostra-lhe os botões com as funcionalidades principais.

Ícones da Barra de Ferramentas

Nova sessão

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.

Modo apenas de procura

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.

Substituição Simulada

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.

Adicionar Textos

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

Apagar Textos

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

Editar Textos

Este botão edita um determinado texto seleccionado.

Apagar Lista

Este botão remove todos os textos da lista.

Inverter Textos

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.

Carregar uma Lista de Textos

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

Procurar em Sub-Pastas

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

Criar Cópias de Segurança

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

Procura com Distinção de Maiúsculas/Minúsculas

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

Comandos

Este botão activa a capacidade dos comandos. Os comandos são sequências de texto especiais. Veja a secção sobre os “Comandos”.

Expressões regulares

Este botão activa as expressões regulares do tipo do Qt.

A Lista de Resultados
A Lista de Resultados

A Lista de Resultados


Área de resultados do KFileReplace

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 direito do rato na lista que contém a posição da linha e coluna.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

A Lista de Textos
A Lista de Textos

A Lista de Textos

Esta é a área de Textos:


Área de textos do KFileReplace

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

A Janela de Nova Sessão
A Janela de Nova Sessão

A Janela de Nova Sessão

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.

A Página Geral


A página Geral do KFileReplace

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 Procurar Agora, caso contrário deixe o campo de procura vazio e carregue em Procurar Mais Tarde.

A página Avançado


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



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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

A Janela de Opções
A Janela de Opções

A Janela de Opções

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

Opções avançadas


A página Avançado da janela de Opções
Não mostrar os ficheiros se não forem encontrados ou substituídos textos: mostra apenas os ficheiros que correspondem a algum dos seus textos. Isto irá acelerar a procura.
Ao procurar, parar no primeiro texto encontrado: 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.
Seguir as ligações simbólicas: se um ficheiro for uma ligação para outro, então procura no ficheiro real.
Ignorar os ficheiros e pastas escondidos: se forem encontrados ficheiros ou pastas escondidos, ignora-os.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

A Janela para Adicionar Textos
A Janela para Adicionar Textos

A Janela para Adicionar Textos


A janela para Adicionar um Texto do KFileReplace

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 3. Funcionalidades do KFileReplace
Funcionalidades do KFileReplace
Anterior
Próximo

Capítulo 3. Funcionalidades do KFileReplace

Este capítulo oferece algumas informações sobre algumas 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_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.

Como Criar um Relatório Simples
Como Criar um Relatório Simples

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Como Usar as Expressões Regulares
Como Usar as Expressões Regulares

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Como Proteger os Ficheiros Originais
Como Proteger os Ficheiros Originais

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Como Abrir um Ficheiro
Como Abrir um Ficheiro

Como Abrir um Ficheiro

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 direito do rato. Irá aparecer um menu, onde depois só terá de seleccionar uma opção dele. Lembre-se que, se usar o KFileReplace incorporado no Quanta Plus, poderá abrir directamente o ficheiro nele, na linha e coluna indicadas.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Comandos
Comandos

Comandos

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 4. Créditos e Licença
Créditos e Licença
Anterior
Próximo

Capítulo 4. Créditos e Licença

KFileReplace. Programa copyright 1999 por François Dupoux , 2003 Andras Mantia , 2004 Gulmini Emiliano

Os autores e equipa de manutenção do KFileReplace:

François Dupoux

Autor original

Andras Mantia

Autor da 'shell', criador da KPart, co-manutenção

Emiliano Gulmini

Manutenção actual, limpeza e reescrita de código

Documentação copyright (c) 2004 Emiliano Gulmini

Tradução de Pedro Morais

A documentação está licenciada ao abrigo da GNU Free Documentation License.

Este programa está licenciado ao abrigo da GNU General Public License.

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Apêndice A. Instalação
Instalação
Anterior
Próximo

Apêndice A. Instalação

Como instalar o KFileReplace

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.

Requisitos
Requisitos

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Apêndice B. Comandos do KFileReplace
Comandos do KFileReplace
Anterior

Apêndice B. Comandos do KFileReplace

[$datetime:iso$]: este comando devolve a data e hora actuais no formato ISO do Qt™.
[$datetime:local$]: como o anterior, mas no formato local.
[$user:uid$]: devolve o UID do utilizador actual.
[$user:gid$]: devolve o GID do utilizador actual.
[$user:loginname$]: devolve o nome do utilizador actual.
[$user:fullname$]: devolve o nome completo do utilizador actual.
[$user:homedir$]: devolve a pasta pessoal do utilizador actual.
[$user:shell$]: devolve a linha de comandos do utilizador actual.
[$loadfile:/local/pasta/o-meu-ficheiro$]: devolve o conteúdo do ficheiro meu-ficheiro.
[$empty:$]: devolve um texto vazio.
[$random:UM_NUMERO_INTEIRO$]: devolve um número aleatório, usando o UM_NUMERO_INTEIRO como raiz inicial dos números aleatórios.
[$random:$]: como o anterior, mas sem raiz inicial.
[$mathexp:expressão-do-bc$]: devolve o resultado de uma expressão matemática do bc v1.06.

Anterior
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Próximo
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team