Emiliano Gulmini Traduzione della documentazione in italiano: Federico Zenith
2
Indice 1 Introduzione 5 2 Usare KFileReplace 6 2.1 La barra degli strumenti.................................. 6 2.2 L elenco dei risultati.................................... 8 2.3 L elenco delle stringhe................................... 8 2.4 La finestra di ricerca e sostituzione nei file........................ 8 2.4.1 La scheda Generale................................ 9 2.4.2 La scheda Avanzate................................ 10 2.5 La finestra Opzioni..................................... 10 2.5.1 Opzioni generali.................................. 10 2.5.2 Opzioni avanzate.................................. 11 2.6 La finestra di inserimento stringhe di ricerca e sostituzione.............. 12 3 Funzionalità di KFileReplace 13 3.1 Come salvare il tuo elenco di stringhe.......................... 13 3.2 Come creare un rapporto semplice............................ 14 3.3 Come usare le espressioni regolari............................ 14 3.4 Come proteggere i file originali.............................. 14 3.5 Come aprire un file..................................... 15 3.6 Comandi........................................... 15 4 Riconoscimenti e licenza 16 A Installazione e compilazione 17 A.1 Requisiti........................................... 17 B Comandi di KFileReplace 18
Sommario KFileReplace è un programma per la ricerca e sostituzione di stringhe.
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. 5
Capitolo 2 Usare KFileReplace 2.1 La barra degli strumenti La barra degli strumenti di KFileReplace dovrebbe apparire così: La barra degli strumenti ti mostra i pulsanti delle funzionalità principali. ICONE DELLA BARRA DEGLI STRUMENTI 6
Personalizza la sessione di ricerca e sostituzione 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. Cerca Questo pulsante avvia un ciclo di ricerca. Simula Questo pulsante avvia un ciclo di ricerca e sostituzione simulato. In pratica non accade nulla quando fai clic su questo pulsante. Sostituisci Questo pulsante avvia un ciclo di ricerca e sostituzione. Quando viene trovata una stringa KFileReplace la sostituisce con un altra. Interrompi Questo pulsante interrompe un operazione. Aggiungi stringa Questo pulsante apre la finestra Aggiungi stringhe in cui puoi modificare il tuo elenco di stringhe. Elimina stringa Questo pulsante elimina la stringa selezionata (o quella attuale se non ce n è una selezionata) dall elenco. Modifica la stringa selezionata Questo pulsante modifica una stringa selezionata. Elenco delle stringhe vuote Questo pulsante elimina tutte le stringhe nell elenco. Inverti la stringa corrente Questo pulsante scambia le stringa di ricerca con quella di sostituzione, così puoi invertire un operazione di ricerca e sostituzione. Carica l elenco delle stringhe da un file Questo pulsante carica un elenco di stringhe salvato in un file xml con estensione kfr. Includi sottocartelle Questo pulsante ti permette di cercare e sostituire ricorsivamente nelle sottocartelle della tua cartella base. Crea copie di sicurezza Questo pulsante abilita la generazione dei file di copia di sicurezza. 7
Distinzione delle maiuscole Questo pulsante abilita la distinzione delle maiuscole nella ricerca. Abilita i comandi nella stringa di sostituzione Questo pulsante abilita le funzionalità dei comandi. I comandi sono stringhe speciali. Vedi Sezione 3.6. Abilita le espressioni regolari Questo pulsante abilita le espressioni regolari in stile Qt. 2.2 L elenco dei risultati La vista dei 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. 2.3 L elenco delle stringhe Questa è la vista delle stringhe: La vista delle stringhe visualizza l elenco delle stringhe che vuoi cercare e sostituire. Nota che nella modalità di ricerca la vista dei risultati e la vista delle stringhe hanno uno schema diverso. 2.4 La finestra di ricerca e sostituzione nei file La finestra Cerca e sostituisci nei file si usa per configurare i parametri di base necessari al funzionamento di KFileReplace. Consiste di due schede, Generale e Avanzate. 8
2.4.1 La scheda Generale Quando vuoi iniziare una nuova sessione il primo passo è fare clic sul pulsante Personalizza la sessione di ricerca e sostituzione. 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. 1 Nota che le espressioni regolari e i comandi potrebbero rallentare le prestazioni. 9
2.4.2 La scheda Avanzate 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). 2.5 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. 2.5.1 Opzioni generali Queste opzioni sono state presentate nella sezione Barra degli strumenti. 10
2.5.2 Opzioni avanzate 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. 11
2.6 La finestra di inserimento stringhe di ricerca e sostituzione 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. 12
Capitolo 3 Funzionalità di KFileReplace Questo capitolo fornisce informazioni su alcune utili funzionalità di KFileReplace. 3.1 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[ SEARCH_STRING_1 ]] ></ oldstring > <newstring ><![ CDATA[ REPLACE_STRING_1 ]] ></ newstring > </ replacement > <replacement > <oldstring ><![ CDATA[ SEARCH_STRING_2 ]] ></ oldstring > <newstring ><![ CDATA[ REPLACE_STRING_2 ]] ></ newstring > </ replacement > <replacement > <oldstring ><![ CDATA[ SEARCH_STRING_N ]] ></ oldstring > <newstring ><![ CDATA[ REPLACE_STRING_N ]] ></ newstring > </ replacement > 13
</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. 3.2 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. 3.3 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. 3.4 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. 14
3.5 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. 3.6 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 meravi glie nel mini-editor di ricerca, e la stringa [$loadfile: /il-percorso-alla-mia-car tella/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 per un elenco esaustivo. 15
Capitolo 4 Riconoscimenti e licenza KFileReplace. Copyright del programma 1999 di François Dupoux dupoux@dupoux.com, 2003 di Andras Mantia amantia@kde.org, 2004 di Emiliano Gulmini emi_barbarossa@yahoo.it GLI AUTORI E I RESPONSABILI DI KFILEREPLACE: François Dupoux dupoux@dupoux.com Autore originale Andras Mantia amantia@kde.org Autore della shell, creatore della KPart, corresponsabile Emiliano Gulmini emi_barbarossa@yahoo.it Responsabile attuale, ripulitore del codice e riscrittore Copyright della documentazione 2004 Emiliano Gulmini emi_barbarossa@yahoo.it Federico Zenithfederico.zenith@member.fsf.org 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. 16
Appendice A Installazione e compilazione KFileReplace fa parte del progetto KDE http://www.kde.org/. Puoi trovare KFileReplace nel pacchetto kdewebdev all indirizzo ftp://ftp.kde.org/pub/kde/, il sito FTP principale del progetto KDE. Per avere informazioni dettagliate su come compilare e installare le applicazioni di KDE, vedi Building and Running KDE Software From Source Siccome KDE usa cmake non dovresti avere problemi a compilarle. incontrarne, segnalali alle liste di distribuzione di KDE. Se invece dovessi A.1 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 (philnelson@acm.org). 17
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. 18