<othercredit role="translator"><firstname>Federico</firstname><surname>Zenith</surname><affiliation><address><email>federico.zenith@member.fsf.org</email></address></affiliation><contrib>Traduzione della documentazione in italiano</contrib></othercredit>
<para>&tdefilereplace; è 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. </para>
<para>Questo pulsante mostra una <link linkend="tdefilereplace-the-project-dialog">finestra di sessione</link> in cui puoi impostare diverse opzioni di base; se &tdefilereplace; viene eseguito come applicazione indipendente dovresti fare clic su questo pulsante come primo passo.</para>
<para>Questo pulsante apre la finestra <link linkend="tdefilereplace-the-add-dialog">Aggiungi stringhe</link> in cui puoi modificare il tuo elenco di stringhe.</para>
<para>Questo pulsante carica un <link linkend="tdefilereplace-the-kfr-file">elenco di stringhe</link> salvato in un file xml con estensione <literal role="extension">kfr</literal>.</para>
<para>La vista <guilabel>Risultati</guilabel> 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.</para>
<para>La vista <guilabel>Stringhe</guilabel> visualizza l'elenco delle stringhe che vuoi cercare e sostituire. Nota che nella modalità di ricerca la vista <guilabel>Risultati</guilabel> e la vista <guilabel>Stringhe</guilabel> hanno uno schema diverso.</para>
<para>La finestra <guilabel>Nuova sessione</guilabel> è usata per configurare i parametri di base necessari al funzionamento di &tdefilereplace;. Consiste di due schede, <guilabel>Generale</guilabel> e <guilabel>Avanzate</guilabel>. </para>
<para>Quando vuoi iniziare una nuova sessione il primo passo è fare clic sul <link linkend="tdefilereplace-the-toolbar">pulsante <guiicon>Nuova sessione</guiicon></link>. Poi devi inserire il percorso di base e una sequenza di caratteri jolly simili a quelli della shell da usare come filtro.</para>
<para>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<footnote id="performancewarning"><para>Per piacere, nota che le espressioni regolari e i comandi potrebbero rallentare le prestazioni.</para></footnote>, fare una copia di sicurezza dei ogni file prima della sostituzione.</para>
<para>Se vuoi iniziare la ricerca, puoi mettere una stringa nel riquadro di ricerca e premere <guibutton>Cerca ora</guibutton>, altrimenti lascia in bianco il riquadro di ricerca e premi <guibutton>Cerca più tardi</guibutton>.</para>
<para>La scheda <guilabel>Avanzate</guilabel> 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 &tdefilereplace; 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).</para>
<para>Questa finestra contiene delle opzioni che sono nella barra degli strumenti e opzioni aggiuntive che potrebbero essere utili in certe situazioni. Puoi chiamarla selezionando <menuchoice><guimenu>Impostazioni</guimenu><guimenuitem>Configura KFileReplace</guimenuitem></menuchoice> nel menu principale. </para>
<seg>mostra solo i file che corrispondono a qualcuna delle tue stringhe. Ciò sveltirà la ricerca.</seg>
<seg>&tdefilereplace; si fermerà quando trova una stringa corrispondente, e continuerà a cercare altre stringhe o, se cerchi solo una stringa, continuerà con il prossimo file.</seg>
<seg>se un file è un collegamento a un altro, cerca il file vero e proprio.</seg>
<seg>se si trovano file o cartelle nascosti, ignorali.</seg>
<para>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 <guibutton>OK</guibutton>.</para>
<title>Come salvare il tuo elenco di stringhe</title>
<para>Quando vuoi riutilizzare un elenco di stringhe puoi salvarlo in un file <literal role="extension">xml</literal>. Per farlo seleziona <menuchoice><guimenu>Cerca/Sostituisci</guimenu><guisubmenu>Stringhe</guisubmenu><guimenuitem>Salva l'elenco delle stringhe in un file</guimenuitem></menuchoice> dalla barra dei menu. Quando salvi un elenco, viene creato un semplice file <literal role="extension">xml</literal> con estensione <literal role="extension">kfr</literal>. Per caricare un file <literal role="extension">kfr</literal> seleziona <menuchoice><guimenu>Cerca/Sostituisci</guimenu><guisubmenu>Stringhe</guisubmenu><guimenuitem>Carica l'elenco delle stringhe da un file</guimenuitem></menuchoice> dalla barra dei menu. Il file ha circa quest'aspetto:</para>
<para>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 &tdefilereplace; nel modo prima descritto.</para>
<para>Puoi creare un rapporto scegliendo <menuchoice><guimenu>Cerca/Sostituisci</guimenu><guisubmenu>Risultati</guisubmenu><guimenuitem>Crea file di rapporto</guimenuitem></menuchoice> dal menu principale. Un rapporto è una cartella contenente un file <literal role="extension">xml</literal> e un <literal role="extension">css</literal>. I rapporti possono essere utili per mantenere un semplice registro delle tue operazioni. <screenshot>
<screeninfo>La funzionalità dei rapporti di &tdefilereplace;</screeninfo>
<para>Se vuoi cercare ogni stringa che cominci per <quote>x</quote>, <quote>ht</quote> o <quote>u</quote>, e finisce per <quote>ml</quote>, puoi scrivere un'espressione regolare come questa: <userinput>(x|ht|u)ml</userinput>. Inserisci questa espressione nell'editor di ricerca, fai clic su <guibutton>OK</guibutton>, e abilita le espressioni regolari premendo il <link linkend="tdefilereplace-the-toolbar">pulsante <guibutton>Espressione regolare</guibutton></link>. 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 <quote>se vuoi risolvere un problema con le espressioni regolari, hai due problemi</quote>.</para>
<para>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 <link linkend="tdefilereplace-the-toolbar">pulsante <guiicon>Copia di sicurezza</guiicon></link>. Se vuoi personalizzare l'estensione dei file della copia di sicurezza apri la <link linkend="tdefilereplace-the-options-dialog">finestra <guilabel>Opzioni</guilabel></link>. </para>
<para>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. Se usi &tdefilereplace; incorporato in &quantaplus;, puoi aprire il file alla riga e colonna specificate direttamente da lì.</para>
<para>Poniamo che vuoi sostituire la frase <quote>Alice nel paese delle meraviglie</quote> con <ulink url="http://www.textlibrary.com/download/alice-wo.txt">l'intero file contenente la versione inglese della favola di Carroll</ulink>. Probabilmente non vuoi farlo a mano, quello di cui hai bisogno è un comando che lo farà per te. Fai clic sul pulsante <link linkend="tdefilereplace-the-toolbar"><guiicon>Aggiungi</guiicon></link>, seleziona <guilabel>Modalità di ricerca e sostituzione</guilabel> e inserisci le stringhe seguenti: <userinput>Alice nel paese delle meraviglie</userinput> nel mini-editor di ricerca, e la stringa <userinput>[$loadfile:<replaceable>/il-percorso-alla-mia-cartella/la-mia-cartella/il-mio-file</replaceable>$]</userinput> nel mini-editor di sostituzione. Fai clic su <guibutton>OK</guibutton>. Quando ritorni alla finestra principale di &tdefilereplace;, attiva il pulsante delle <link linkend="tdefilereplace-the-toolbar">azioni dei comandi</link> che abilita i comandi, e avvia il processo di sostituzione. Ci sono anche altri comandi, vedi <xref linkend="available-commands"/> per un elenco esaustivo.</para>
<para>&tdefilereplace;. Copyright del programma 1999 di François Dupoux <email>dupoux@dupoux.com</email>, 2003 di Andras Mantia <email>amantia@kde.org</email>, 2004 di Emiliano Gulmini <email>emi_barbarossa@yahoo.it</email> </para>
<para>&tdefilereplace; fa attualmente parte del pacchetto &tdewebdev;, quindi per installarlo devi avere una copia di &tdewebdev;. Nota che se stai usando un'installazione di &kde; data dal fornitore del tuo sistema operativo, probabilmente hai già &tdewebdev; installato; in questo caso, puoi usare &tdefilereplace; o aprendo l'editor Web &quantaplus;, o chiamandolo direttamente (a meno che tu abbia una versione vecchia di &kde;). Altrimenti puoi scaricare il pacchetto &tdewebdev; da Internet: riferisciti al <ulink url="http://kdewebdev.org">sito Web di &tdewebdev;</ulink> per maggiori informazioni. </para>
<para>Per usare il comando <link linkend="available-commands">[$mathexp:<replaceable>qualche_espressione_matematica</replaceable>$]</link> dovresti prima installare il programma matematico &bc; (versione 1.06 o più recente) scritto da Philip A. Nelson (<email>philnelson@acm.org</email>).</para>
