Manuale di KFileReplace
Manuale di KFileReplace
Avanti

Manuale di KFileReplace

Emiliano Gulmini

Traduzione della documentazione in italiano: Federico Zenith
Revisione 1.0.0 (2004-08-09)

È concesso il permesso di copiare, distribuire ovvero modificare questo documento sotto i termini della GNU Free Documentation License, versione 1.1 o qualsiasi versione successiva pubblicata dalla Free Software Foundation; con nessuna sezione invariante, con nessun testo di copertina anteriore e con nessun testo di copertina posteriore. Una copia di questa licenza è inclusa nella sezione intitolata "GNU Free Documentation License".

KFileReplace è un programma per la ricerca e sostituzione di stringhe.


Capitolo 1. Introduzione
Introduzione
Indietro
Avanti

Capitolo 1. Introduzione

KFileReplace è un'applicazione usata per cercare e sostituire un elenco di stringhe in albero di file. Le stringhe possono essere letterali o espressioni regolari come in Qt™. Ci sono anche altre opzioni per regolare la tua ricerca.

Indietro
Avanti
Partenza


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

Capitolo 2. Usare KFileReplace
Usare KFileReplace
Indietro
Avanti

Capitolo 2. Usare KFileReplace


KFileReplace usato da solo

La barra degli strumenti

La barra degli strumenti di KFileReplace dovrebbe apparire così:


La barra degli strumenti di KFileReplace

La barra degli strumenti ti mostra i pulsanti delle funzionalità principali.

Icone della barra degli strumenti

Nuova sessione

Questo pulsante mostra una finestra di sessione in cui puoi impostare diverse opzioni di base; se KFileReplace viene eseguito come applicazione indipendente dovresti fare clic su questo pulsante come primo passo.

Sola ricerca

Questo pulsante avvia un ciclo di ricerca.

Sostituisci

Questo pulsante avvia un ciclo di ricerca e sostituzione. Quando viene trovata una stringa KFileReplace la sostituisce con un'altra.

Sostituzione simulata

Questo pulsante avvia un ciclo di ricerca e sostituzione simulato. In pratica non accade nulla quando fai clic su questo pulsante.

Interrompi

Questo pulsante interrompe un'operazione.

Aggiungi stringhe

Questo pulsante apre la finestra Aggiungi stringhe in cui puoi modificare il tuo elenco di stringhe.

Elimina stringhe

Questo pulsante elimina la stringa selezionata (o quella attuale se non ce n'è una selezionata) dall'elenco.

Modifica stringhe

Questo pulsante modifica una stringa selezionata.

Elimina elenco

Questo pulsante elimina tutte le stringhe nell'elenco.

Inverti stringhe

Questo pulsante scambia le stringa di ricerca con quella di sostituzione, così puoi invertire un'operazione di ricerca e sostituzione.

Carica elenco di stringhe

Questo pulsante carica un elenco di stringhe salvato in un file xml con estensione kfr.

Cerca nelle sottocartelle

Questo pulsante ti permette di cercare e sostituire ricorsivamente nelle sottocartelle della tua cartella base.

Fai copia di sicurezza dei file

Questo pulsante abilita la generazione dei file di copia di sicurezza.

Ricerca con distinzione delle maiuscole

Questo pulsante abilita la distinzione delle maiuscole nella ricerca.

Comandi

Questo pulsante abilita le funzionalità dei comandi. I comandi sono stringhe speciali. Vedi la sezione chiamata “Comandi”.

Espressioni regolari

Questo pulsante abilita le espressioni regolari in stile Qt.

L'elenco dei risultati
L'elenco dei risultati

L'elenco dei risultati


La vista dei risultati di KFileReplace

La vista Risultati mostra il nome dei file che contengono le stringhe che devi trovare (e sostituire), il loro percorso, le loro dimensioni, il numero di stringhe trovate e l'ID utente dei file. Questa vista dà anche la posizione esatta di ogni corrispondenza. Puoi anche aprire un file facendo clic con il tasto destro del mouse su una voce della vista a elenco che contiene la posizione di riga e colonna.



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

L'elenco delle stringhe
L'elenco delle stringhe

L'elenco delle stringhe

Questo è la vista Stringhe:


La vista Stringhe di KFileReplace

La vista Stringhe visualizza l'elenco delle stringhe che vuoi cercare e sostituire. Nota che nella modalità di ricerca la vista Risultati e la vista Stringhe hanno uno schema diverso.



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

La finestra Nuova sessione
La finestra Nuova sessione

La finestra Nuova sessione

La finestra Nuova sessione è usata per configurare i parametri di base necessari al funzionamento di KFileReplace. Consiste di due schede, Generale e Avanzate.

La scheda Generale


La vista Stringhe di KFileReplace

Quando vuoi iniziare una nuova sessione il primo passo è fare clic sul pulsante Nuova sessione. Poi devi inserire il percorso di base e una sequenza di caratteri jolly simili a quelli della shell da usare come filtro.

Poi potresti usare un insieme di opzioni utili, come cercare in tutte le sottocartelle, fare una ricerca con distinzione delle maiuscole, abilitare i comandi o le espressioni regolari[1], fare una copia di sicurezza dei ogni file prima della sostituzione.

Se vuoi iniziare la ricerca, puoi mettere una stringa nel riquadro di ricerca e premere Cerca ora, altrimenti lascia in bianco il riquadro di ricerca e premi Cerca più tardi.

La scheda Avanzate


La scheda Avanzate di KFileReplace

La scheda Avanzate ti permette di impostare alcune opzioni utili per limitare la ricerca a un sottoinsieme del tuo albero di file in cui cerchi. Se vuoi eseguire KFileReplace solo sui file che hanno delle dimensioni nell'intervallo da 10 a 100KB, potresti usare le opzioni delle dimensioni. C'è anche un'opzione della data che limita la ricerca in un intervallo di tempo, e un'ultima opzione che ti permette di cercare solo i file appartenenti (o non appartenenti) a un certo utente (questo potrebbe essere più utile agli amministratori di sistema).



[1] Per piacere, nota che le espressioni regolari e i comandi potrebbero rallentare le prestazioni.



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

La finestra Opzioni
La finestra Opzioni

La finestra Opzioni

Questa finestra contiene delle opzioni che sono nella barra degli strumenti e opzioni aggiuntive che potrebbero essere utili in certe situazioni. Puoi chiamarla selezionando Impostazioni->Configura KFileReplace nel menu principale.

Opzioni generali

Queste opzioni sono state presentate nella sezione Barra degli strumenti.


La scheda Generale della finestra Opzioni

Opzioni avanzate


La scheda Avanzate della finestra Opzioni
Non mostrare i file se non sono trovare né sostituite stringhe: mostra solo i file che corrispondono a qualcuna delle tue stringhe. Ciò sveltirà la ricerca.
Durante la ricerca, fermati alla prima stringa trovata: KFileReplace si fermerà quando trova una stringa corrispondente, e continuerà a cercare altre stringhe o, se cerchi solo una stringa, continuerà con il prossimo file.
Segui i collegamenti simbolici: se un file è un collegamento a un altro, cerca il file vero e proprio.
Ignora i file e le cartelle nascoste: se si trovano file o cartelle nascosti, ignorali.



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

La finestra Aggiungi stringhe
La finestra Aggiungi stringhe

La finestra Aggiungi stringhe


La finestra Aggiungi stringhe di KFileReplace

Questa finestra viene usata per inserire e modificare un elenco di stringhe. Devi solo inserire un elenco di sola ricerca o di ricerca e sostituzione, e poi inserirai il tuo testo con i due mini-editor. I tasti freccia ti permettono di aggiungere coppie di stringhe o eliminarle. Quando hai finito, fai clic su OK.



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

Indietro
Avanti
Partenza


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

Capitolo 3. Funzionalità di KFileReplace
Funzionalità di KFileReplace
Indietro
Avanti

Capitolo 3. Funzionalità di KFileReplace

Questo capitolo fornisce informazioni su alcune utili funzionalità di KFileReplace.

Come salvare il tuo elenco di stringhe

Quando vuoi riutilizzare un elenco di stringhe puoi salvarlo in un file xml. Per farlo seleziona Cerca/Sostituisci->Stringhe->Salva l'elenco delle stringhe in un file dalla barra dei menu. Quando salvi un elenco, viene creato un semplice file xml con estensione kfr. Per caricare un file kfr seleziona Cerca/Sostituisci->Stringhe->Carica l'elenco delle stringhe da un file dalla barra dei menu. Il file ha circa quest'aspetto:

<?xml version="1.0" ?>
<kfr>
        <mode search="false"/>
        <replacement>
                <oldstring
><![CDATA[STRINGA_DI_RICERCA_1]] 
></oldstring>
                <newstring
><![CDATA[STRINGA_DI_SOSTITUZIONE_1]]
></newstring>
        </replacement>
        <replacement>
                <oldstring
><![CDATA[STRINGA_DI_RICERCA_2]]
></oldstring>
                <newstring
><![CDATA[STRINGA_DI_SOSTITUZIONE_2]]
></newstring>
        </replacement>
        <replacement>
                <oldstring
><![CDATA[STRINGA_DI_RICERCA_N]]
></oldstring>
                <newstring
><![CDATA[STRINGA_DI_SOSTITUZIONE_N]]
></newstring>
        </replacement>

</kfr
>

Se stai usando un formato precedente, puoi aggiornare il tuo file a mano modificandolo secondo lo schema sopra. In alternativa, puoi caricare il file scritto nel vecchio formato e risalvarlo con KFileReplace nel modo prima descritto.

Come creare un rapporto semplice
Come creare un rapporto semplice

Come creare un rapporto semplice

Puoi creare un rapporto scegliendo Cerca/Sostituisci->Risultati->Crea file di rapporto dal menu principale. Un rapporto è una cartella contenente un file xml e un css. I rapporti possono essere utili per mantenere un semplice registro delle tue operazioni.


La funzionalità dei rapporti di KFileReplace



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

Come usare le espressioni regolari
Come usare le espressioni regolari

Come usare le espressioni regolari

Se vuoi cercare ogni stringa che cominci per “x”, “ht” o “u”, e finisce per “ml”, puoi scrivere un'espressione regolare come questa: (x|ht|u)ml. Inserisci questa espressione nell'editor di ricerca, fai clic su OK, e abilita le espressioni regolari premendo il pulsante Espressione regolare. Nota che usare le espressioni regolari ti permette di fare ricerche molto complicate, ma il costo potrebbe essere una riduzione delle prestazioni. Le espressioni regolari possono essere molto difficili, ed è spesso vero che “se vuoi risolvere un problema con le espressioni regolari, hai due problemi”.



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

Come proteggere i file originali
Come proteggere i file originali

Come proteggere i file originali

Se non vuoi perdere i tuoi file originali, puoi farne una copia prima di sostituire le stringhe. Dopo aver inserito le tue stringhe, e prima di avviare il processo di sostituzione, devi solo attivare il pulsante Copia di sicurezza. Se vuoi personalizzare l'estensione dei file della copia di sicurezza apri la finestra Opzioni.



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

Come aprire un file
Come aprire un file

Come aprire un file

Se vuoi aprire un file che corrisponde ad alcune delle tue stringhe, devi selezionare una riga nella vista dei risultati e farci clic con il tasto destro del mouse. Apparirà un menu contestuale dal quale puoi aprire il file. Se usi KFileReplace incorporato in Quanta Plus, puoi aprire il file alla riga e colonna specificate direttamente da lì.



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

Comandi
Comandi

Comandi

Poniamo che vuoi sostituire la frase “Alice nel paese delle meraviglie” con l'intero file contenente la versione inglese della favola di Carroll. Probabilmente non vuoi farlo a mano, quello di cui hai bisogno è un comando che lo farà per te. Fai clic sul pulsante Aggiungi, seleziona Modalità di ricerca e sostituzione e inserisci le stringhe seguenti: Alice nel paese delle meraviglie nel mini-editor di ricerca, e la stringa [$loadfile:/il-percorso-alla-mia-cartella/la-mia-cartella/il-mio-file$] nel mini-editor di sostituzione. Fai clic su OK. Quando ritorni alla finestra principale di KFileReplace, attiva il pulsante delle azioni dei comandi che abilita i comandi, e avvia il processo di sostituzione. Ci sono anche altri comandi, vedi Appendice B, Comandi di KFileReplace per un elenco esaustivo.



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

Indietro
Avanti
Partenza


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

Capitolo 4. Riconoscimenti e licenza
Riconoscimenti e licenza
Indietro
Avanti

Capitolo 4. Riconoscimenti e licenza

KFileReplace. Copyright del programma 1999 di François Dupoux , 2003 di Andras Mantia , 2004 di Emiliano Gulmini

Gli autori e i responsabili di KFileReplace:

François Dupoux

Autore originale

Andras Mantia

Autore della shell, creatore della KPart, co-responsabile

Emiliano Gulmini

Responsabile attuale, ripulitore del codice e riscrittore

Copyright (c) della documentazione 2004 Emiliano Gulmini

Federico Zenith

Questa documentazione è concessa in licenza sotto i termini della GNU Free Documentation License.

Questo programma è concesso in licenza sotto i termini della GNU General Public License.

Indietro
Avanti
Partenza


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

Appendice A. Installazione
Installazione
Indietro
Avanti

Appendice A. Installazione

Come installare KFileReplace

KFileReplace fa attualmente parte del pacchetto kdewebdev, quindi per installarlo devi avere una copia di kdewebdev. Nota che se stai usando un'installazione di KDE data dal fornitore del tuo sistema operativo, probabilmente hai già kdewebdev installato; in questo caso, puoi usare KFileReplace o aprendo l'editor Web Quanta Plus, o chiamandolo direttamente (a meno che tu abbia una versione vecchia di KDE). Altrimenti puoi scaricare il pacchetto kdewebdev da Internet: riferisciti al sito Web di kdewebdev per maggiori informazioni.

Requisiti
Requisiti

Requisiti

Per usare il comando [$mathexp:qualche_espressione_matematica$] dovresti prima installare il programma matematico bc (versione 1.06 o più recente) scritto da Philip A. Nelson ().



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

Indietro
Avanti
Partenza


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

Appendice B. Comandi di KFileReplace
Comandi di KFileReplace
Indietro

Appendice B. Comandi di KFileReplace

[$datetime:iso$]: questo comando restituisce la data e l'ora correnti nel formato ISO di Qt™.
[$datetime:local$]: come sopra ma in formato locale.
[$user:uid$]: restituisce l'UID dell'utente attuale.
[$user:gid$]: restituisce il GID dell'utente attuale.
[$user:loginname$]: restituisce il nome dell'utente attuale.
[$user:fullname$]: restituisce il nome completo dell'utente attuale.
[$user:homedir$]: restituisce la cartella Home dell'utente attuale.
[$user:shell$]: restituisce la shell dell'utente attuale.
[$loadfile:/miopercorso/miacartella/miofile$]: restituisce i contenuti del file miofile.
[$empty:$]: restituisce la stringa vuota.
[$random:UN_NUMERO_INTERO$]: restituisce un numero casuale usando UN_NUMERO_INTERO come seme iniziale.
[$random:$]: come sopra, ma senza seme iniziale.
[$mathexp:espressione-bc$]: restituisce il risultato di un'espressione matematica bc v1.06.

Indietro
Partenza


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

Avanti
 


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