Manual do KFileReplace
Manual do KFileReplace
Próxima

Manual do KFileReplace

Emiliano Gulmini

Tradução: Marcus Gama
Revisão 1.0.0 (2004-08-09)

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


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

Capítulo 1. Introdução

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.

Anterior
Próxima
Principal


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

Capítulo 2. Usando o KFileReplace
Usando o KFileReplace
Anterior
Próxima

Capítulo 2. Usando o KFileReplace


O KFileReplace em sua apresentação de aplicativo separado

A Barra de Ferramentas

A barra de ferramentas do KFileReplace se parece com isto:


Barra de ferramentas do KFileReplace

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

Ícones da Barra de Ferramentas

Nova sessão

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.

Somente procurar

Este botão inicia um ciclo de busca.

Substituir

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

Substituição Simulada

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

Parar

Este botão para a operação.

Adicionar Textos

Este botão abre o diálogo Adicionar Textos no qual você pode editar sua lista de textos.

Apagar Textos

Este botão remove um texto selecionado (ou o atual se nenhum estiver selecionado) da lista.

Editar Textos

Este botão edita um texto selecionado.

Apagar Lista

Este botão exclui todos os textos na lista.

Inverter Textos

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.

Carregar Lista de Textos

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

Procurar nas Sub-pastas

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

Criar Arquivos de Cópia de Segurança

Este botão ativa a geração de arquivos de cópias de segurança.

Procura Sensível à Caixa

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

Comandos

Este botão ativa a capacidade dos comandos. Os comandos são sequências de texto especiais. Veja “Comandos”.

Expressões regulares

Este botão ativa as expressões regulares estilo Qt.

A Lista de Resultados
A Lista de Resultados

A Lista de Resultados


Visão de Resultados do KFileReplace

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 direto do mouse na entrada da 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 visão de Textos:


Visão de Textos do KFileReplace

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.



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

O Diálogo Nova Sessão
O Diálogo Nova Sessão

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


Página Geral KFileReplace

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 Procurar Agora, caso contrário deixe a caixa de procura vazia e pressione Procurar Depois.

A Página Avançado


A página Avançado do KFileReplace

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



[1] Por favor observe que expressões regulares e comandos podem diminuir o desempenho da operação.



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

O Diálogo Opções
O Diálogo Opções

O Diálogo Opções

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 Configurações->Configurar o KFileReplace... do menu principal.

Opções gerais

Estas opções foram apresentadas na seção da Barra de Ferramentas.


A janela de Opções da página Geral

Opções avançadas


A janela de Opções da página Avançado
Do not show files if no strings are found or replaced: shows only the files that match some of your strings. This will speed up the search.
When searching, stop on first string found: KFileReplace will stop when it finds a matching string, and will continue to search for other strings or, if you search for only 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: if hidden files or folders are encountered, ignore them.



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

O Diálogo Adicionar Textos
O Diálogo Adicionar Textos

O Diálogo Adicionar Textos


O diálogo Adicionar Textos do KFileReplace

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



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

Anterior
Próxima
Principal


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

Capítulo 3. Recursos do KFileReplace
Recursos do KFileReplace
Anterior
Próxima

Capítulo 3. Recursos do KFileReplace

Este capítulo fornece informações sobre alguns recursos úteis do 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 é:

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

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

Como Criar um Relatório Simples

Você poderá criar um relatório se escolher a opção Procurar/Substituir->Resultados->Criar um Arquivo de Relatório 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.


Recurso 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 Expressões Regulares
Como usar Expressões Regulares

Como usar Expressões Regulares

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 OK, e ative as expressões regulares alternando o botão Expressão Regular. 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”.



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

Como Proteger os Arquivos Originais
Como Proteger os Arquivos Originais

Como Proteger os Arquivos Originais

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.



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

Como Abrir um Arquivo
Como Abrir um Arquivo

Como Abrir um Arquivo

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 direto do mouse a partir do qual você poderá abrir o arquivo. Lembre-se que, se usar o KFileReplace incorporado no Quanta Plus, você poderá abrir diretamente o arquivo 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

Suponhamos 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:/caminho/meuarquivo$] no mini-editor de substituição. Clique no botão Ok. 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.



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

Anterior
Próxima
Principal


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óxima

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

Direitos autorais do programa KFileReplace de François Dupoux , 2003 Andras Mantia , 2004 Emiliano Gulmini

Os autores e mantenedores do KFileReplace:

François Dupoux

Autor original

Andras Mantia

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

Emiliano Gulmini

Manutenção atual, limpeza & reescrita de código

Direitos autorais da documentação 2004 Emiliano Gulmini

Tradução de Marcus Gama

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.

Anterior
Próxima
Principal


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óxima

Apêndice A. Instalação

Como instalar o KFileReplace

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.

Requisitos
Requisitos

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



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

Anterior
Próxima
Principal


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$]: this command return the current date and time in Qt ISO format.
[$datetime:local$]: like above but in local format.
[$user:uid$]: return the UID of the current user.
[$user:gid$]: return the GID of the current user.
[$user:loginname$]: return the login name of the current user.
[$user:fullname$]: return the full name of the current user.
[$user:homedir$]: return the home directory of the current user.
[$user:shell$]: return the shell of the current user.
[$loadfile:/my-path/my-directory/my-file$]: return the content of the my-file file.
[$empty:$]: return the empty string.
[$random:AN_INTEGER_NUMBER$]: return a random number string using AN_INTEGER_NUMBER as the initial seed.
[$random:$]: like above, but without initial seed.
[$mathexp:bc-expression$]: return the result of a bc v1.06 mathematical expression.

Anterior
Principal


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

Próxima
 


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