# Manuale di &kfilereplace;

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

## Usare &kfilereplace;

&kfilereplace; usato da solo &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 di &kfilereplace;

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

### Icone della barra degli strumenti

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.

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 kfilereplace-commands.

Abilita le espressioni regolari

- Questo pulsante abilita le espressioni regolari in stile &Qt;.

### L'elenco dei risultati

La vista dei risultati di &kfilereplace; La vista dei risultati di &kfilereplace;

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 &RMB; su una voce della vista a elenco che contiene la posizione di riga e colonna.

### L'elenco delle stringhe

Questa è la vista delle stringhe: La vista Stringhe di &kfilereplace; La vista Stringhe di &kfilereplace;

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.

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

#### La scheda Generale

La scheda Generale di &kfilereplace; La vista Stringhe di &kfilereplace;

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

Nota che le espressioni regolari e i comandi potrebbero rallentare le prestazioni.

, 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 avanzata di &kfilereplace; La scheda avanzata 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).

### 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 La scheda Generale della finestra Opzioni

#### Opzioni avanzate

La scheda Avanzate della finestra Opzioni La scheda Avanzate della finestra Opzioni

Non mostrare i file se non sono trovare né sostituite stringhe Durante la ricerca, fermati alla prima stringa trovata Segui i collegamenti simbolici Ignora i file e le cartelle nascoste
- mostra solo i file che corrispondono a qualcuna delle tue stringhe. Ciò sveltirà la ricerca. &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. se un file è un collegamento a un altro, cerca il file vero e proprio. se si trovano file o cartelle nascosti, ignorali.

### La finestra di inserimento stringhe di ricerca e sostituzione

La finestra di inserimento stringhe di ricerca e sostituzione di &kfilereplace; La finestra di inserimento stringhe di ricerca e sostituzione 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.

## 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[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>

    </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

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; La funzionalità dei rapporti di &kfilereplace;

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

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

### 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 &RMB;. Apparirà un menu contestuale dal quale puoi aprire il file.

### 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 available-commands per un elenco esaustivo.

## 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

&underFDL; &underGPL;

## Installazione e compilazione

&install.intro.documentation; &install.compile.documentation;

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

## Comandi di &kfilereplace;

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

&documentation.index;