<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
><firstname
>Nicola</firstname
><surname
>Ruggero</surname
><contrib
>Traduzione della documentazione</contrib
></othercredit
><othercredit role="translator"
><firstname
>Federico</firstname
><surname
>Zenith</surname
><affiliation
><address
><email
>federico.zenith@member.fsf.org</email
></address
></affiliation
><contrib
>Traduzione della documentazione</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Lavorare con le estensioni</title>

<para
>Kate usa due diversi tipi di estensione: quelle per l'applicazione completa di &kate;, e quelle per il solo componente editor. Queste ultime sono disponibili per qualsiasi applicazione usi il componente editor, come KDevelop, Quanta, Kile, Kwrite e molte altre. Le estensioni per l'applicazione sono invece specificamente per &kate;.</para>

<para
>Puoi abilitare entrambi i tipi di estensioni nella <link linkend="configuring-kate-configdialog"
>finestra di configurazione</link
>, che dà anche accesso alle opzioni di configurazione aggiuntive per le estensioni che le richiedano.</para>

<para
>Ci sono molte estensioni disponibili per diversi scopi, e puoi trovarne delle altre sul Web. Alcune sono distribuite assieme al componente editor, come le graffe automatiche, l'inserimento dei file, gli strumenti di dati, e  l'esportazione di testo come &HTML;.</para>

<sect1 id="kate-editor-plugins">
<title
>Estensioni del componente editor</title>

<para
>La scheda <guilabel
>Estensioni</guilabel
> della pagina omonima elenca tutte le estensioni disponibili, e puoi spuntare quelle che vuoi usare. Fai clic sul pulsante <guilabel
>Informazioni</guilabel
> per aprire la finestra <guibutton
>Informazioni su...</guibutton
> dell'estensione.</para>
<para
>Una volta che un'estensione configurabile è spuntata, si attiva il pulsante <guibutton
>Configura</guibutton
>, e ci puoi fare clic per configurare l'estensione selezionata.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Graffe automatiche</guilabel
></term>
<listitem
><para
>L'estensione per graffe automatiche sostituisce la funzionalità interna di &kate; per le <quote
>parentesi automatiche</quote
>. Inserisce automaticamente una graffa chiusa, <keycap
>}</keycap
>, in fondo alla riga successiva dopo aver concluso una riga con una aperta, <keycap
>{</keycap
>, e aver premuto il tasto &Enter;.</para
></listitem>
</varlistentry>
<!--http://jakob.petsovits.at/topic/kate-->
<!--Right, it's the automatic insertion of a closing brace ("}") after you ended a line with an opening one ("{"). Kate's standard insertion of parentheses, brackets and braces is simply too obtrusive for me, so even if I tried it several times I always had to disable it again because I can't stand it. So here's how AutoBrace works.
You, the developer, are writing a line of code, and want to open a new block delimited by braces. Looks like this:
If you press Enter and AutoBrace is enabled, it will insert your favorite new brace where it belongs. Looks like this:
-->
<varlistentry>
<term
><guilabel
>Strumenti per dati</guilabel
></term>
<listitem
><para
>Abilita gli strumenti di dati come il dizionario dei sinonimi e il controllo ortografico (se installato). Gli strumenti di dati sono disponibili solo quando c'è del testo selezionato, o quando il &RMB; viene premuto su una parola. Se non sono presenti strumenti di dati, anche quando c'è del testo selezionato, devi installarli. Alcuni strumenti di dati fanno parte del pacchetto &koffice;. Se questa estensione è abilitata e gli strumenti di dati sono installati, appariranno degli altri elementi in fondo al menu contestuale.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><link linkend="kate-editor-plugin-exporter"
><guilabel
>Esportazione</guilabel
></link
></term>
<listitem
><para
>Questo comando permette di esportare il documento attuale con tutte le informazioni di evidenziazione in un documento HTML con <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Esporta come HTML</guimenuitem
></menuchoice
>. Inoltre, puoi usare <menuchoice
><guimenu
>Modifica</guimenu
><guimenuitem
>Copia come HTML</guimenuitem
></menuchoice
> per copiare il testo attualmente selezionato come HTML negli appunti di sistema.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Inserimento di icone</guilabel
></term>
<listitem
><para
>L'estensione di inserimento delle icone è utile solo agli sviluppatori di &kde;: aggiunge un elemento <guimenuitem
>Inserisci codice per KIcon</guimenuitem
> nel menu contestuale dell'editor. Se attivo, si apre il menu di selezione delle icone di &kde; (mostrando le icone per le applicazioni, le azioni e così via). Se fai clic su una di esse, il suo nome del file senza estensione verrà inserito come testo. È utile solo per impostare le icone con l'infrastruttura di &kde; con la classe KIcon. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Redazione di HTML folle (non Zen, edizione leggera)</guilabel
></term>
<listitem
><para
>Un'estensione che fa codice Zen come il completamento a selettori. Per maggiori informazioni vedi <ulink url="http://en.wikipedia.org/wiki/Zen_Coding"
>cos'è il codice Zen</ulink
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Inserisci file</guilabel
></term>
<listitem
><para
>Questa estensione permette di inserire qualsiasi file leggibile alla posizione del cursore. Se abilitata, il menu <guimenu
>Strumenti</guimenu
> avrà l'ulteriore elemento <guimenuitem
>Inserisci file</guimenuitem
>.</para
></listitem>
</varlistentry>
<!-- not build any longer in kde 4.5
<varlistentry>
<term
>Python Encoding check</term>
<listitem
><para
>This plugin is always enabled.  
If you are trying to save a python file as non ASCII, without specifying a 
correct source encoding line like &eg; <quote
># -*- coding: utf-8 -*-</quote
>, 
a warning dialog pops up and allows you to add a proper source encoding line for the
current encoding to the file.
</para
></listitem>
</varlistentry>
-->
</variablelist>
<!--
kdelibs/kate/plugins/ has additional plugins
autobookmark not build, its broken!
timedate not build? plugin is for howto-write-a-plugin purposes!
-->

<!-- Scripts tab ??? empty: Not implemented yet, hidden in 4.4 + 4.7  branch, removed in master bye bye-->
</sect1>

<sect1 id="kate-application-plugins">
<title
>Estensioni dell'applicazione &kate;</title>

<!-- from doc/kate-addons/index.docbook -->
<para
>Le estensioni di &kate; sono funzioni aggiuntive per l'editor &kate;. Possono aggiungere nuovi menu e scorciatoie, ed estendere le funzionalità di &kate;. Puoi installarne quante ne vuoi dall'interno di &kate;. Apri la finestra di configurazione di &kate; con <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura Kate...</guimenuitem
></menuchoice
>. Seleziona <menuchoice
><guimenu
>Applicazione</guimenu
><guimenuitem
>Estensioni</guimenuitem
></menuchoice
> per scegliere quelle che vuoi. </para>

<para
>Le estensioni per l'applicazione disponibili sono: </para>
<itemizedlist>
<listitem>
<para
><link linkend="kate-application-plugin-findinfiles"
>Strumento di ricerca nei file</link
>: vista che permette di cercare in tutti i file aperti o nel filesystem;</para>
</listitem>
<listitem>
<para
>GDB: una semplice interfaccia a GDB;</para>
<!-- GDB Plugin http://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
</listitem>
<listitem>
<para
>Browser di backtrace: vista degli strumenti di navigazione di backtrace;</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-quickswitcher"
>Cambio rapido dei documenti</link
>: passa rapidamente a un altro documento già aperto;</para>
</listitem>
<listitem>
<para
>Estensione SQL: interroga banche dati SQL;</para>
</listitem>
<listitem>
<para
>Estensione di ricerca: trova un modello nei file;</para>
</listitem>
<listitem>
<para
>Barra di schede: aggiunge una barra delle linguette normale alla finestra principale di &kate;;</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
<!--listitem>
<para
>Text Snippets - Configurable Text Snippets</para>
</listitem-->
<listitem>
<para
>Filtro di testo: filtraggio facile del testo;</para>
</listitem>
<listitem>
<para
>Visore di simboli: estrae e visualizza i simboli di riferimento dal sorgente;</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Browser del filesystem</link
>: strumento di visualizzazione del filesystem;</para>
</listitem>
<listitem>
<para
>Strumento visivo per terminale: vista che incorpora un terminale;</para>
</listitem>
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<listitem>
<para
>Estensione CTags: cerca definizioni e dichiarazioni con CTags;</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-filetemplate"
>Modelli di file</link
>: crea nuovi file partendo da dei modelli;</para>
</listitem>
<listitem>
<para
>Apri intestazioni: apri il file <literal role="extension"
>.h/[.cpp|.c]</literal
>;</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-exttools"
>Strumenti esterni</link
></para>
</listitem>
<listitem>
<para
>Estensione di generazione: compila o esegui <command
>make</command
> ed elabora i messaggi d'errore;</para>
<!-- http://kate-editor.org/2011/06/21/kate-plugin-updates-part-1/ -->
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-mail"
>Invia file</link
>: invia file per posta elettronica;</para>
</listitem>
<listitem>
<para
>Barra di schede multilinea: aggiunge una barra delle linguette con più righe alla finestra principale di &kate;;</para>
</listitem>
<listitem>
<para
>Frammenti di Kate: estensione per frammenti con supporto per il completamento del codice;</para>
</listitem>
<listitem>
<para
>Estensione di pronuncia Jovie: aggiunge una voce del menu per pronunciare il testo;</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmlcheck"
>Validazione &XML;</link
>: valida i file &XML; con <command
>xmllint</command
>;</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>Completamento &XML;</link
>: elenca elementi, attributi, valori di attributi ed entità permessi dalla DTD;</para>
</listitem>
<listitem>
<para
>Schedatura: aggiunge una barra delle linguette alla finestra principale di &kate;.</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
</itemizedlist>
</sect1>

<!-- from doc/kate-addons/filetemplates.docbook -->
<sect1 id="kate-application-plugin-filetemplate">
<sect1info>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
</authorgroup>
</sect1info>
<title
>Modelli di file</title>

  <para
>L'estensione per i modelli di file permette di creare file in base ad altri file.</para>
  <para
>Quando si installa &kate; per la prima volta, si deve abilitare l'estensione:</para>
  <orderedlist>
        <listitem>
          <para
>Fai clic su <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura Kate</guimenuitem
></menuchoice
>. </para>
        </listitem>
        <listitem>
          <para
>Nell'albero sulla sinistra, fai clic su <guilabel
>Estensioni</guilabel
>. </para>
        </listitem>
        <listitem>
          <para
>Nel pannello <guilabel
>Gestore delle estensioni</guilabel
> a destra, seleziona <guilabel
>Modelli di file</guilabel
>, e fai quindi clic su <guibutton
>OK</guibutton
>. </para>
        </listitem>
   </orderedlist>
  <para
>Si può ora usare qualsiasi file come modello (ciò crea una copia del file con un &URL; vuoto). Dei file modello speciali possono contenere macro per inserire informazioni come nomi, indirizzi di posta, la data attuale, e posizionare il cursore in un posto appropriato del nuovo file.</para>
  <para
>Si può facilmente creare un nuovo modello da un documento aperto.</para>
  <para
>I modelli salvati nella cartella dei modelli sono elencati nel menu <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Nuovo da modello</guimenuitem
></menuchoice
>.</para>
  <para
>La cartella dei modelli fa parte del filesystem di &kde;, e consiste almeno di:</para>
    <itemizedlist>
      <listitem>
	<para>
	 <filename role="directory"
>$<envar
>KDEDIR</envar
>/share/applications/kate/plugins/katefiletemplates/templates</filename>
	</para>
      </listitem>
      <listitem>
       <para>
        <filename role="directory"
>$<envar
>KDEHOME</envar
>/share/applications/kate/plugins/katefiletemplates/templates</filename>
	</para>
      </listitem>
    </itemizedlist>
    <para
>Se la variabile d'ambiente <envar
>KDEDIRS</envar
> contiene altre cartelle, saranno cercate delle sottocartelle simili anche in queste. Se vengono trovati modelli con lo stesso nome, viene scelto quello nella cartella locale (<filename class="directory"
>$<envar
>KDEHOME</envar
></filename
>).</para>
  <sect2 id="katefiletemplates-menu">
    <title
>Struttura dei menu</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>File</guimenu
> <guisubmenu
>Nuovo da modello</guisubmenu
> <guimenuitem
>Qualsiasi file</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Presenta il selettore dei file, che permette di usare qualsiasi file come modello. Se il file scelto ha l'estensione <literal role="extension"
>.katetemplate</literal
>, verrà analizzato alla ricerca di informazioni del modello e di macro.</para
></listitem>
      </varlistentry>
      <!-- not in 4.4
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu
>File</guimenu>
            <guisubmenu
>New From Template</guisubmenu>
            <guimenuitem
>Use Recent</guimenuitem>
          </menuchoice>
        </term>
        <listitem
><para
>Presents a list of files recently used as
            templates, represented by their &URL;.</para
></listitem>
      </varlistentry>
      -->
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Nuovo da modello</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Il resto dei sottomenu contiene dei collegamenti a modelli. Fai clic su un elemento per creare un file come descritto dal suo testo.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Gestisci modelli...</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Questo avvierà una finestra con un elenco di tutti i modelli trovati nelle cartelle dei modelli, insieme alle opzioni di aggiungerne, modificarli o rimuoverli.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="katefiletemplates-use">
    <title
>Usare un modello di &kate;</title>
    <para
>Quando si crea un file da un modello che contenga delle macro per modelli, alcune macro appaiono come variabili modificabili nel testo. Queste variabili appaiono nel testo come parole sottolineate.</para>
    <para
>La prima variabile sarà selezionata, quindi devi solo scrivere per modificarla. Se il testo del documento contiene più occorrenze della stessa variabile, vengono cambiate mentre la modifichi. Per andare alla variabile modificabile successiva, premi il tasto &Tab;. Quando è stata modificata l'ultima variabile, l'elenco viene rimosso, e il tasto &Tab; funziona come normale.</para>
  </sect2>

  <sect2 id="katefiletemplates-create">
    <title
>Creare i tuoi modelli</title>
    <para
>Per creare un nuovo modello, usa l'elemento <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Gestisci modelli</guimenuitem
></menuchoice
> per avviare la finestra di gestione dei modelli. In questa, fai clic su <guibutton
>Nuovo...</guibutton
> per avviare l'assistente dei modelli di file. Verranno chiesti un file facoltativo da far diventare modello e le impostazioni delle sue informazioni, e sarà quindi creato un file modello.</para
> <para
>In alternativa, puoi creare un modello manualmente aggiungendone le informazioni all'inizio di qualsiasi file, aggiungere testo e macro, e salvarlo con l'estensione <literal role="extension"
>.katetemplate</literal
>.</para>
    <para
>Il menu dei modelli viene aggiornato automaticamente se scegli di salvare il modello nella cartella dei modelli.</para>
  </sect2>

  <sect2 id="katefiletemplates-edit">
    <title
>Modificare i modelli</title>
    <para
>Per modificare un modello, usa <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Gestisci modelli...</guimenuitem
></menuchoice
>. Seleziona il modello sul quale vuoi lavorare e fai clic su <guibutton
>Modifica...</guibutton
>, e il file del modello verrà aperto. Chiudi la finestra, modifica il file del modello come desideri, salvalo e chiudilo. I cambiamenti ai modelli hanno effetto immediato, puoi attivare il modello per provare le modifiche dopo averlo salvato.</para>
  </sect2>

  <sect2 id="katefiletemplates-format">
    <title
>Il formato dei modelli di &kate;</title>
    <para
>Se usi dei file con estensione <literal role="extension"
>.katetemplate</literal
>, saranno analizzati alla ricerca di informazioni, macro del modello e una posizione del cursore.</para>

    <sect3 id="katefiletemplates-template-info">
      <title
>Informazioni del modello</title>
      <para
>Leggendo nel file, il programma di analisi tiene da parte le righe che cominciano per <constant
>katetemplate:</constant
> e ci cerca le informazioni di modello nella forma <replaceable
>nome_variabile</replaceable
>=<replaceable
>valore</replaceable
>. La prima riga che non comincia per <constant
>katetemplate:</constant
> sarà considerata l'inizio dei contenuti del modello. <replaceable
>valore</replaceable
> può contenere qualsiasi carattere tranne il segno di uguale (<symbol
>=</symbol
>). I nomi di variabile ammessi sono: <variablelist>
          <varlistentry>
            <term
><varname
>Template</varname
></term>
            <listitem
><para
>Questo è il nome del modello, mostrato nel menu <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Nuovo da modello</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Group</varname
></term>
            <listitem
><para
>Il gruppo posiziona il modello in un sottomenu del menu <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Nuovo da modello</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Name</varname
></term>
            <listitem
><para
>Questo è il nome che sarà impostato per il documento, e mostrato nell'elenco dei file e nella barra del titolo. Se il nome contiene <userinput
>%N</userinput
>, questo verrà rimpiazzato con un numero, aumentandolo se ci sono altri documenti con lo stesso nome.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Highlight</varname
></term>
            <listitem
><para
>L'estensione cercherà di impostare l'evidenziazione del nuovo documento al valore di questa variabile. Il valore dovrebbe essere un nome, come si trova nel menu <menuchoice
><guimenu
>Strumenti</guimenu
><guimenuitem
>Modalità di evidenziazione</guimenuitem
></menuchoice
>.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Description</varname
></term>
            <listitem
><para
>Una breve descrizione informativa del modello. È attualmente usata per impostare una stringa <guilabel
>Che cos'è?</guilabel
> per l'elemento del menu, ma potrà essere usata per altre cose in futuro.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Author</term>
            <listitem
><para
>Una stringa che identifica l'autore, per esempio nella forma <userinput
>Nome &lt;indirizzo di posta&gt;</userinput
>. È attualmente usata per impostare una stringa <guilabel
>Che cos'è?</guilabel
> per l'elemento del menu, ma potrà essere usata per altre cose in futuro.</para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect3>

    <sect3 id="katetemplates-macros">
      <title
>Macro dei modelli</title>

      <para
>Nell'analisi dei contenuti del modello, vengono espanse le macro nella forma <userinput
>%{<replaceable
>nome</replaceable
>}</userinput
> o <userinput
>${<replaceable
>nome</replaceable
>}</userinput
>. Se usi il prefisso <userinput
>$</userinput
>, la macro espansa sarà trattata come variabile modificabile quando viene creato un documento dal modello, mentre se usi <userinput
>%</userinput
> non lo sarà, a meno che l'espansione non riesca.</para>
      <para
>Vengono espanse le macro seguenti: <variablelist>
          <varlistentry
><term
><literal
>time</literal
></term>
            <listitem
><para
>Si espande nell'ora attuale nel formato locale.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>date</literal
></term>
            <listitem
><para
>Si espande alla data attuale nel formato breve.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>datetime</literal
></term>
            <listitem
><para
>Si espande alle data e ora correnti, formattate come una stringa secondo le impostazioni locali.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>year</literal
></term>
            <listitem
><para
>L'anno corrente come numero di quattro cifre.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>month</literal
></term>
            <listitem
><para
>Il nome completo del mese corrente, secondo la localizzazione.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>day</literal
></term>
            <listitem
><para
>Si espande all'attuale giorno del mese.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>hostname</literal
></term>
            <listitem
><para
>Si espande al nome host del computer.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>index</literal
></term>
            <listitem
><para
>Si espande a <userinput
>i</userinput
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>fullname</literal
></term>
            <listitem
><para
>Si espande al tuo nome completo, come definito nell'indirizzo del proprietario nella rubrica di &kde;.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>firstname</literal
></term>
            <listitem
><para
>Si espande al tuo nome, come definito nell'indirizzo del proprietario nella rubrica di &kde;.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>lastname</literal
></term>
            <listitem
><para
>Si espande al tuo cognome, come definito nell'indirizzo del proprietario nella rubrica di &kde;.</para>
            </listitem>
          </varlistentry>
          <!-- <varlistentry>
            <term
>username</term>
            <listitem
><para
>Expands to your username.</para
></listitem>
          </varlistentry
> -->
          <varlistentry>
            <term
>email</term>
            <listitem
><para
>Si espande al tuo indirizzo di posta elettronica, come definito nell'indirizzo del proprietario nella rubrica di &kde;.</para
></listitem>
          </varlistentry>
          <!--<varlistentry>
            <term
>organisation</term>
            <listitem
><para
>This is your organisation, as defined by
                the owner address in your standard KDE
                addressbook.</para
></listitem>
          </varlistentry
>-->
        </variablelist>
      </para>
      <para
>Qualsiasi macro al di fuori dall'elenco qui sopra è trattata come modificabile, indipendentemente dal prefisso. Se la stessa variabile ricorre più volte nel modello, può essere modificata immediatamente dopo aver creato un documento dal modello.</para>
    </sect3>

    <sect3 id="katefiletemplates-cursor">
      <title
>Impostare la posizione del cursore</title>
      <para
>La macro speciale <userinput
>${cursor}</userinput
> sarà sostituita con una barra verticale e aggiunta alla fine dell'elenco delle variabili modificabili, indipendentemente dalla sua posizione nel testo.</para>
    </sect3>

  </sect2>
  <sect2>
    <title
>Ringraziamenti e riconoscimenti</title>
    <para
>Estensione di &kate; <quote
>Modelli di file</quote
>, copyright 2004 di &Anders.Lund; &Anders.Lund.mail;. </para>
    <para
>Copyright della documentazione 2004 di &Anders.Lund;.</para>
  </sect2>
</sect1>

<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1 id="kate-application-plugin-xmlcheck">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>

<title
>Validazione &XML;</title>

<para
>Questa estensione controlla che i file &XML; siano validi e scritti in forma corretta.</para>
<para
>L'estensione controlla il file attuale. Sul fondo della finestra principale di &kate; apparirà un elenco di avvertimenti ed errori. Puoi fare clic su un messaggio d'errore per saltare al punto corrispondente nel file. Se il file ha un <quote
>DOCTYPE</quote
>, si userà il suo DTD per controllarne la validità. Ci si aspetta che il DTD sia in posizione relativa al file attuale: per esempio se il doctype si riferisce a <filename
>DTD/xhtml1-transitional.dtd</filename
> e il file è <filename
>/home/pippo/prova.xml</filename
>, ci si aspetta che il DTD sia a <filename
>/home/pippo/DTD/xhtml1-transitional.dtd</filename
>. Comunque, sono supportati anche i DTD remoti specificati con http.</para>

<para
>Se il file non ha un doctype, ne sarà controllata la corretta formattazione.</para>

<para
>Per saperne di più su &XML;, vedi le <ulink url="http://www.w3.org/XML/"
>pagine ufficiali del W3C su &XML;</ulink
>.</para>

<para
>Internamente, questa estensione chiama il comando esterno <command
>xmllint</command
>, che fa parte di libxml2. Se questo comando non è correttamente installato sul sistema, l'estensione non funzionerà.</para>

<note
><para
>Deve essere scritto un file temporaneo nella stessa cartella del file che viene controllato, quindi avrai bisogno dell'accesso in scrittura a quella cartella.</para
></note>

<para
>Per caricare questa estensione apri la finestra di configurazione di &kate; sotto <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura Kate...</guimenuitem
></menuchoice
>. Seleziona quindi <guilabel
>Validazione XML</guilabel
> che apparirà nella sezione <guilabel
>Estensioni</guilabel
>, sotto <guilabel
>Applicazione</guilabel
>, e chiudi la finestra. </para>

<sect2 id="xmlcheck-menu">
<title
>Struttura dei menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Convalida XML</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Questo avvierà il controllo, come sopra descritto.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Ringraziamenti e riconoscimenti</title>
<para
>Estensione di &kate; <quote
>Validazione XML</quote
>, copyright 2002 di &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Copyright 2002 della documentazione di &Daniel.Naber;</para>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-xmltools">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>
<title
>Completamento &XML;</title>

<para
>Questa estensione suggerisce cosa è ammissibile in un certo punto di un file &XML;, secondo la DTD del file. Elencherà i possibili elementi, attributi, valori degli attributi o entità a seconda della posizione del cursore (per esempio, se il carattere a sinistra del cursore è <quote
>&amp;</quote
>, vengono elencate tutte le entità). È anche possibile chiudere l'ultimo tag aperto a sinistra.</para>

<para
>La <acronym
>DTD</acronym
> deve esistere in formato &XML;, come prodotta dal programma Perl <command
>dtdparse</command
>. Indicheremo una tale DTD come <quote
>meta-DTD</quote
>. Sono fornite alcune meta-DTD; sono installate in <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/apps/katexmltools/</filename
>, che è anche la cartella predefinita alla selezione di <guimenuitem
>Assegna meta-DTD</guimenuitem
>. Per produrre le tue meta-DTD, recupera <command
>dtdparse</command
> da <ulink url="http://dtdparse.sourceforge.net"
>questo indirizzo</ulink
>.</para>

<sect2 id="xmltools-how-to-use">
<title
>Uso</title>

<para
>Avvia &kate; e apri apri la finestra di configurazione sotto <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura Kate</guimenuitem
></menuchoice
>. Seleziona quindi <guilabel
>Completamento XML</guilabel
> che apparirà nella sezione <guilabel
>Estensioni</guilabel
>, sotto <guilabel
>Applicazione</guilabel
>, e chiudi la finestra. Dopodiché, seleziona <menuchoice
><guimenu
>XML</guimenu
><guimenuitem
>Assegna meta-DTD</guimenuitem
></menuchoice
>. Se il documento non contiene nessun <quote
>DOCTYPE</quote
> o questo è ignoto, dovrai selezionare una meta-DTD dal filesystem. Altrimenti, la meta-DTD corrispondente al DOCTYPE del documento attuale sarà automaticamente caricata.</para>

<para
>Puoi ora usare l'estensione mentre scrivi del testo:</para>

<variablelist>

<varlistentry>
<term
><keycap
>&lt;</keycap
> (minore)</term>
<listitem
><para
>Questo attiverà un elenco di elementi possibili, a meno che il cursore sia già dentro a un tag. Nota che attualmente non puoi usarlo per inserire degli elementi di massimo livello (per esempio <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycombo action="seq"
><keycap
>&lt;</keycap
><keycap
>/</keycap
></keycombo
> (minore e sbarra)</term>
<listitem
><para
>Inserire questi caratteri chiuderà l'elemento attuale (l'ultimo aperto a sinistra del cursore). Premi &Enter; per accettare il suggerimento. Al contrario dell'elemento del menu <guimenuitem
>Chiudi elemento</guimenuitem
>, questo funziona solo quando è stata assegnata una DTD.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>"</keycap
> (virgolette)</term>
<listitem
><para
>Il tasto delle virgolette attiverà un elenco di valori possibili per gli attributi (se ce ne sono) se sei all'interno di un tag.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&nbsp;</keycap
> (spazio)</term>
<listitem
><para
>Questo tasto attiverà un elenco di attributi possibili per l'elemento attuale se sei dentro a un tag.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (e commerciale)</term>
<listitem
><para
>Questo tasto attiverà un elenco di entità.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-features-and-limitations">
<title
>Funzionalità e limiti</title>

<para
>Puoi provare tutte le funzioni e i limiti caricando in &kate; <filename
>$<envar
>KDEDIR</envar
>/share/apps/katexmltools/testcases.xml</filename
> e seguendo le istruzioni.</para>

</sect2>


<sect2 id="xmltools-menu">
<title
>Struttura dei menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Enter;</keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Inserisci elemento</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Questo aprirà una finestra che permette di inserire un elemento &XML;. Saranno inseriti automaticamente i caratteri &lt;, &gt; e il tag di chiusura. Se avevi selezionato del testo al momento della selezione di questo elemento del menu, il testo sarà incluso tra i tag di apertura e chiusura. La finestra offre il completamento per tutti gli elementi che possono essere inseriti alla posizione attuale del cursore se hai assegnato una meta-DTD con <guimenuitem
>Assegna meta-DTD</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Chiudi elemento</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Questo cercherà nel testo un tag non ancora chiuso e lo chiuderà inserendone il tag di chiusura corrispondente. La ricerca parte alla posizione del cursore e va verso sinistra. Se non è possibile trovare un tag aperto, non succederà nulla.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Assegna meta-DTD</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Questo dirà all'estensione quale meta-DTD usare per il documento attuale. Nota che questa assegnazione non verrà salvata. La dovrai ripetere al prossimo riavvio di &kate;.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Ringraziamenti e riconoscimenti</title>
<para
>Estensione di &kate; <quote
>Completamento XML</quote
>, copyright 2001, 2002 di &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Copyright della versione per KDE SC 4 2010 di Tomáš Trnka</para>
<para
>Copyright 2001, 2002 della documentazione di &Daniel.Naber;</para>
</sect2>

</sect1>

<sect1 id="kate-application-plugin-quickswitcher">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Cambio rapido dei documenti</title>

<sect2 id="quickswitcher-menu">
<title
>Struttura dei menu</title>

<variablelist>
<varlistentry
> 
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>1</keycap
> </keycombo
></shortcut
><guimenu
>Vai</guimenu
><guimenuitem
>Cambio rapido</guimenuitem
></menuchoice
></term>
<listitem
><para
>Apre la finestra <guilabel
>Cambio rapido dei documenti</guilabel
> con un campo di ricerca e un elenco di file aperti. Inserendo del testo nel campo, lo si cerca tra i nomi e gli &URL; dei documenti. Mentre inserisci il testo nel campo di ricerca puoi usare i tasti <keycap
>↑</keycap
> e <keycap
>↓</keycap
> per scorrere la vista a elenco. Se si lascia la finestra premendo <guilabel
>OK</guilabel
>, l'estensione fa passare la vista al documento selezionato nella vista a elenco. Ciò facilita il passaggio tra i documenti, se ce ne sono molti aperti. </para
></listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>

<sect1 id="kate-editor-plugin-exporter">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Esportazione</title>

<sect2 id="exporter-menu">
<title
>Struttura dei menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Esporta come HTML</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Esporta il file in formato &HTML; in modo che il documento possa essere visualizzato come una pagina Web. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Modifica</guimenu
><guimenuitem
>Copia come HTML</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Copia il testo selezionato con l'evidenziazione della sintassi come testo &HTML;.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-findinfiles">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Trova nei file</title>

<sect2 id="findinfiles-menu">
<title
>Struttura dei menu</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Modifica</guimenu
> <guimenuitem
>Trova nei file</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Avvia la finestra <guilabel
>Trova nei file</guilabel
> per cercare del testo nei file di una cartella.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Visualizza</guimenu
> <guisubmenu
>Viste degli strumenti</guisubmenu
> <guimenuitem
>Mostra Trova nei file</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Attiva o disattiva la visualizzazione dello strumento <guilabel
>Trova nei file</guilabel
> di &kate;. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-searchinfiles">
<sect1info>
<authorgroup
><author
><firstname
>T.C.</firstname
> <surname
>Hollingsworth</surname
> <affiliation
><address
><email
>tchollingsworth@gmail.com</email
></address
></affiliation>
</author
></authorgroup>
</sect1info>
<title
>Ricerca nei file</title>

<sect2 id="searchinfiles-intro">
<title
>Introduzione</title>
<para
>L'estensione di ricerca nei file di &kappname; permette di cercare testo o <link linkend="regular-expressions"
>espressioni regolari</link
> in molti file alla volta. Puoi cercare in tutti i file aperti, o in tutti i file in una cartella, e a scelta nelle sue sottocartelle. Puoi anche filtrare secondo il nome del file, per esempio cercando solo nei file che hanno un'estensione particolare.</para>

<para
>L'estensione di ricerca dei file non è abilitata inizialmente, essendo stata appena introdotta in &kappname; 3.7. Abilitala nel pannello <link linkend="config-dialog-plugins"
>Estensioni</link
> delle impostazioni di &kappname;. Sostituirà la vecchia <link linkend="kate-application-plugin-findinfiles"
>estensione di ricerca nei file</link
> nella prossima versione di &kappname;.</para>

</sect2>

<sect2 id="searchinfiles-ui">
<title
>Interfaccia</title>

<sect3 id="searchinfiles-ui-query">
<title
>Interrogazione di ricerca</title>

<para
>Le opzioni seguenti sono sempre visualizzate in cima alla vista dello strumento di ricerca nei file:</para>

<variablelist>

<varlistentry>
<term
><guiicon
>Nuova scheda</guiicon
></term>
<listitem
><para
>Puoi avere tante ricerche aperte quante vuoi allo stesso tempo. Basta fare clic sul pulsante <guibutton
>Nuova scheda</guibutton
> nell'angolo in alto a sinistra nella vista dello strumento di ricerca, e apparirà una nuova scheda di risultati che permette di effettuare una nuova ricerca. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Interrogazione</term>
<listitem
><para
>La lunga casella di testo in cima è dove scrivi cosa vuoi trovare. Puoi inserire del testo normale, o un'espressione regolare e le abiliti. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Cerca</guibutton
></term>
<listitem
><para
>Quando hai finito di configurare tutto, premi il pulsante <guibutton
>Cerca</guibutton
> per effettuare la ricerca. Puoi anche premere &Enter; nella casella di testo per fare la stessa cosa. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Posizione</guimenu
></term>
<listitem
><para
>Qui ci sono due opzioni. Seleziona <guilabel
>nei file aperti</guilabel
> per cercare tutti i file attualmente aperti &kappname;. Seleziona <guilabel
>nella cartella</guilabel
> per cercare in una cartella e a scelta nelle sue sottocartelle. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Opzioni</guimenu
></term>
<listitem
><para
>Ci sono due opzioni disponibili. Se abilitata, <guilabel
>Distingui le maiuscole</guilabel
> limiterà i risultati della ricerca a quelli che hanno la stessa combinazione di lettere maiuscole e minuscole del testo di ricerca. L'opzione <guilabel
>Espressioni regolari</guilabel
> permette di usare le <link linkend="regular-expressions"
>espressioni regolari</link
> invece del testo semplice nell'interrogazione di ricerca. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Commuta risultati</guiicon
></term>
<listitem
><para
>La freccia in basso nell'angolo in alto a destra dello strumento di ricerca nei file scambierà metà della vista dello strumento tra la visualizzazione di opzioni aggiuntive per la modalità di ricerca nelle cartelle e i risultati della ricerca. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-folder">
<title
>Opzioni della ricerca nelle cartelle</title>

<para
>Queste opzioni sono mostrate sotto le opzioni di interrogazione di cui sopra. Se sono invece visualizzati i risultati della ricerca, premi il pulsante <guiicon
>Commuta risultati</guiicon
> per mostrarle. Queste opzioni si applicano solo quando è abilitata la modalità di ricerca nelle cartelle. Se è selezionata la ricerca nei file aperti, saranno disattivate.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Cartella</guilabel
></term>
<listitem
><para
>Puoi inserire il percorso della cartella in cui vuoi cercare. Per esempio, potresti inserire <userinput
>~/sviluppo/kde/kate/</userinput
> se volessi cercare nel codice sorgente di &kate;. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Apri selettore dei file</guiicon
></term>
<listitem
><para
>Premi questo pulsante per localizzare la cartella nel selettore associato al tuo sistema. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Su</guiicon
></term>
<listitem
><para
>Premi questo pulsante per cambiare la <guilabel
>Cartella</guilabel
> alla cartella madre di quella attualmente selezionata. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Ripristina cartella attuale</guiicon
></term>
<listitem
><para
>Questo pulsante imposterà la voce della <guilabel
>Cartella</guilabel
> a quella in cui si trova il documento attuale. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Filtro</guilabel
></term>
<listitem
><para
>Questo permette di cercare dei nomi di file che corrispondono a un certo schema. Per esempio, per cercare solo i file scritti in C++, impostalo a <userinput
>*.cpp</userinput
>. Per cercare solo i file che cominciano per <literal
>kate</literal
>, impostalo a <userinput
>kate*</userinput
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ricorsivo</guilabel
></term>
<listitem
><para
>Se questa opzione è abilitata, &kappname; cercherà anche tutte le sottocartelle della cartella selezionata. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Includi nascosti</guilabel
></term>
<listitem
><para
>Se questa opzione è abilitata, &kappname; cercherà anche nei file o nelle cartelle che sono normalmente nascosti dal sistema operativo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Segui i collegamenti simbolici</guilabel
></term>
<listitem
><para
>L'estensione di ricerca nei file normalmente non segue i <ulink url="http://it.wikipedia.org/wiki/Collegamento_simbolico"
>collegamenti simbolici</ulink
>. Quando questa opzione è abilitata, l'estensione invece li seguirà e cercherà nei file e nelle cartelle a cui riferiscono. </para>
<warning
><para
>È possibile che i collegamenti simbolici puntino alla cartella madre di quella attualmente in esame, o altre cartelle che portino ad essa. Se è presente un simile collegamento e l'opzione è abilitata, &kappname; seguirà ripetutamente il collegamento e la ricerca non si concluderà mai.</para
></warning>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-results">
<title
>Risultati della ricerca</title>

<para
>I risultati della ricerca sono visualizzati sotto le opzioni dell'interrogazione. Se sono mostrate le opzioni per la modalità di ricerca nelle cartelle, basta premere il pulsante <guiicon
>Commuta risultati</guiicon
> per mostrarli. Saranno inoltre automaticamente visualizzati non appena verrà effettuata una ricerca.</para>

<para
>I risultati della ricerca mostrano tre colonne con informazioni su ogni risultato dell'interrogazione di ricerca. La colonna <guilabel
>File</guilabel
> mostra il nome del file. La colonna <guilabel
>Riga</guilabel
> indica il numero della riga in cui i contenuti dell'interrogazione sono stati rilevati. La colonna <guilabel
>Testo</guilabel
> mostra il testo completo di quella riga.</para>

<para
>Per aprire il file in cui è stato trovato il risultato, basta farci doppio clic. &kappname; aprirà quindi il file, se necessario, e posizionerà il cursore all'inizio del testo nel file corrispondente all'interrogazione.</para>

</sect3>
</sect2>

<sect2 id="searchinfiles-menu">
<title
>Struttura dei menu</title>
<variablelist>

<!--<varlistentry>
<term>
<menuchoice>
<guimenu
>Edit</guimenu>
<guimenuitem
>Find in Files...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para
>Launch the <guilabel
>Find in Files</guilabel
> dialog to allow you to
search for text in the files of a folder.</para>
</listitem>
</varlistentry
>-->

<varlistentry>
<term>
<menuchoice
><guimenu
>Visualizza</guimenu
> <guisubmenu
>Viste degli strumenti</guisubmenu
> <guimenuitem
>Mostra Cerca nei file</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Attiva o disattiva la visualizzazione dello strumento <guilabel
>Cerca nei file</guilabel
> di &kappname;. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-mail">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Invia file</title>

<sect2 id="mail-menu">
<title
>Struttura dei menu</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>File</guimenu
> <guimenuitem
>Spedisci</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Apri il programma di posta e allega il file nel messaggio. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-fsbrowser">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Browser del filesystem</title>

<para
>Il browser del filesystem è un visore di cartelle che permette di aprire i file da una cartella aperta nella riquadro attuale.</para>

<sect2 id="fsbrowser-menu">
<title
>Struttura dei menu</title>
<variablelist>

<varlistentry>
<term>
<anchor id="view-toolviews-show-fileselector"/>
<menuchoice
><guimenu
>Visualizza</guimenu
><guisubmenu
>Viste degli strumenti</guisubmenu
><guimenuitem
>Mostra Browser del filesystem</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Mostra o nasconde il browser del filesystem di &kate;.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="fsbrowser-interface">
<title
>Interfaccia</title>

<para
>Dall'alto al basso, il browser del filesystem è composto dai seguenti elementi:</para>

<variablelist>
<varlistentry>
<term
>Una barra degli strumenti</term>
<listitem>
<para
>Questa contiene pulsanti standard per la navigazione:</para>
<variablelist>
<varlistentry>
<term
><guibutton
>Indietro</guibutton
></term>
<listitem
><para
>Fa in modo che la vista delle cartelle si sposti a quella precedentemente visualizzata in ordine cronologico. Questo pulsante è disabilitato se non c'è un elemento precedente nella cronologia.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Avanti</guibutton
></term>
<listitem
><para
>Provoca lo spostamento della vista delle cartelle a quella successiva nella cronologia. Questo pulsante è disattivato se non esiste una cartella successiva nella cronologia.</para
></listitem>
</varlistentry>
<!--varlistentry>
<term
><guibutton
>Parent Folder</guibutton
></term>
<listitem
><para
>This will cause the folder view to <command
>cd</command
> to the immediate parent of the currently displayed
folder if possible.</para
></listitem>
</varlistentry-->
<varlistentry>
<term
><guibutton
>Segnalibri</guibutton
></term>
<listitem
><para
>Apre un sottomenu per modificare o aggiungere segnalibri e per aggiungere una nuova cartella di segnalibri.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Cartella del documento attuale</guibutton
></term>
<listitem
><para
>Questo pulsante manda la vista delle cartelle a quella che contiene il documento attualmente attivo, se possibile. Questo pulsante è disabilitato se il documento attivo è un nuovo file che non è ancora stato salvato, oppure se la cartella in cui risiede non è individuabile.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Opzioni</guibutton
></term>
<listitem>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Vista breve</guimenuitem
></term>
<listitem
><para
>Mostra solo i nomi dei file.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Vista dettagliata</guimenuitem
></term>
<listitem
><para
>Mostra <guilabel
>Nome</guilabel
>, <guilabel
>Data</guilabel
>, <guilabel
>Dimensione</guilabel
> e <guilabel
>Tipo</guilabel
> dei file.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Vista ad albero</guimenuitem
></term>
<listitem
><para
>Come la vista breve, ma le cartelle possono essere espanse per vederne i contenuti.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Vista ad albero dettagliata</guimenuitem
></term>
<listitem
><para
>Anche questa permette di espandere le cartelle, ma mostra le colonne aggiuntive disponibili nella vista dettagliata.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Mostra i file nascosti</guimenuitem
></term>
<listitem
><para
>Mostra i file normalmente nascosti dal sistema operativo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Sincronizza automaticamente con il documento attuale</guimenuitem
></term>
<listitem
><para
>Quando questa opzione è abilitata, il browser del filesystem passerà automaticamente alla cartella del documento attualmente aperto nell'area di modifica ogni volta che cambia.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Un campo di posizione</term>
<listitem>
<para
>Questo mostra una navigazione a briciole della cartella attualmente aperta, come in &dolphin;. Puoi fare clic su qualsiasi cartella per sfogliarla, o fare clic su una delle frecce a sinistra di una cartella per selezionare qualsiasi cartella sottostante. Puoi anche selezionare dall'elenco delle tue Risorse facendo clic sull'icona in fondo a sinistra nella navigazione a briciole, che mostra un'icona che rappresenta la Risorsa attuale.</para>

<para
>Puoi anche fare clic a destra delle briciole per trasformarle in una casella di testo dove puoi digitare il percorso di una cartella da sfogliare. Il campo per &URL; mantiene una lista di tutti i percorsi precedentemente inseriti. Per sceglierne uno usa il pulsante con la freccia sulla destra del campo.</para>
<tip
><para
>Il campo &URL; ha il completamento automatico dei nomi delle cartelle. Il metodo di completamento può essere impostato utilizzando il menu contestuale del campo di inserimento.</para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term
>Una vista delle cartelle</term>
<listitem
><para
>Questa è una vista di cartelle standard di &kde;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Un campo di filtro</term>
<listitem>
<para
>Il campo di filtro permette di definire un filtro per i file visualizzati nella vista delle cartelle. Il filtro usa gli schemi standard; questi devono essere separati da spazi. Per esempio: <userinput
>*.cpp *.h *.moc</userinput
>.</para>
<para
>Per visualizzare tutti i file, inserisci un singolo asterisco <userinput
>*</userinput
>.</para>
<para
>Il campo di filtro salva gli ultimi dieci filtri inseriti durante la sessione. Per usarne uno fai clic sul pulsante con la freccia a destra del campo di inserimento e seleziona il filtro che desideri. Puoi disattivare il filtro premendo il pulsante <guibutton
>Pulisci il testo</guibutton
> a sinistra del pulsante a freccia di autocompletamento.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="fsbrowser-config">
<title
>Configurazione</title>

<para
>Questa estensione può essere configurata nella pagina <guilabel
>Navigatore del filesystem</guilabel
> della <link linkend="configuring-kate-configdialog"
>configurazione di &kate;</link
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Barra degli strumenti</guilabel
></term>
<listitem
><para
>Configura i pulsanti della barra del navigatore del filesystem spostando quelli desiderati nell'elenco <guilabel
>Azioni selezionate</guilabel
>, e ordinali con i pulsanti a freccia di fianco all'elenco.</para>
 </listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--some material from mdi.docbook needs to be migrated here too-->
<sect1 id="kate-application-plugin-exttools">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Strumenti esterni</title>

<para
>Nel menu <guimenu
>Strumenti</guimenu
> troverai un sottomenu chiamato <guisubmenu
>Strumenti esterni</guisubmenu
>, se li hai abilitati nelle impostazioni di &kate;. Questi strumenti richiamano applicazioni esterne con dati relativi al documento attuale, ad esempio l'&URL;, la cartella, il testo o la selezione.</para>

<para
>Gli strumenti esterni sono definibili dall'utente: puoi aggiungerli, modificarli o rimuoverli con il <link linkend="exttools-config"
>pannello di configurazione degli strumenti esterni</link
>. </para>

<sect2 id="exttools-menu">
<title
>Struttura dei menu</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Strumenti</guimenu
><guisubmenu
>Strumenti esterni</guisubmenu
></menuchoice
></term>
<listitem
><para
>Questo sottomenu contiene tutti gli strumenti esterni configurati.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="exttools-config">
<title
>Configurazione</title>

<para
>Gli strumenti esterni vengono configurati nella pagina <guilabel
>Strumenti esterni</guilabel
> della <link linkend="configuring-kate-configdialog"
>configurazione di &kate;</link
>. Questi strumenti richiamano applicazioni esterne con dei dati relativi al documento attuale, per esempio i suoi &URL;, cartella, testo o selezione. Questa pagina permette di gestire il menu e modificare, rimuovere o aggiungere strumenti.</para>

<para
>Ogni strumento esterno è un comando di shell contenente delle macro che rappresentano i dati del documento. All'attivazione, le macro vengono sostituite dai dati del documento attivo.</para>

<variablelist>
<title
>Comandi disponibili</title>

<varlistentry>
<term
><guibutton
>Nuovo</guibutton
></term>
<listitem
><para
>Aggiungi un nuovo strumento esterno all'elenco. Questo avvierà il foglio delle proprietà sotto descritto, in cui puoi configurare uno strumento esterno.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Modifica</guibutton
></term>
<listitem
><para
>Modifica lo strumento attualmente selezionato, con il foglio delle proprietà sotto descritto.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Inserisci separatore</guibutton
></term>
<listitem
><para
>Aggiunge una linea di separazione che compare nel menu sotto l'elemento attualmente selezionato.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Freccia in su</guibutton
></term>
<listitem
><para
>Sposta l'elemento attualmente selezionato sopra il precedente.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Freccia in giù</guibutton
></term>
<listitem
><para
>Sposta l'elemento attualmente selezionato sotto il successivo.</para
></listitem>
</varlistentry>

</variablelist>

<variablelist>
<title
>Proprietà degli strumenti esterni</title>
<varlistentry>
<term
><guilabel
>Etichetta</guilabel
></term>
<listitem
><para
>Un'etichetta amichevole che apparirà nel menu <guisubmenu
>Strumenti esterni</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Icona</guibutton
></term>
<listitem
><para
>Permette di selezionare un'icona che apparirà di fianco all'etichetta nel menu <guisubmenu
>Strumenti esterni</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Script</guilabel
></term>
<listitem
><para
>Lo script da eseguire quando viene attivato lo strumento. Prima di passare lo script alla shell, vengono sostituite le seguenti macro: <variablelist>
<varlistentry>
<term
><userinput
>%URL</userinput
></term>
<listitem
><para
>L'&URL; completo del documento attuale, o una stringa vuota se il documento non è stato salvato.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%URLs</userinput
></term>
<listitem
><para
>Una lista separata da spazi degli &URL; di tutti i documenti aperti (tranne quelli non salvati).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%directory</userinput
></term>
<listitem
><para
>La parte della cartella dell'&URL; del documento attuale, o una stringa vuota se il documento attuale non è stato salvato.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%filename</userinput
></term>
<listitem
><para
>Il nome del file del documento attuale senza il percorso, o una stringa vuota se il documento attuale non è stato salvato.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%line</userinput
></term>
<listitem
><para
>Il numero della riga a cui si trova il cursore di inserimento nel documento attuale.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%column</userinput
></term>
<listitem
><para
>Il numero della colonna a cui si trova il cursore di inserimento nel documento attuale.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%selection</userinput
></term>
<listitem
><para
>Il testo selezionato nel documento attuale, o una stringa vuota se non c'è testo selezionato.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%text</userinput
></term>
<listitem
><para
>Il testo completo del documento attuale. Fai attenzione, perché potrebbe eccedere la lunghezza massima dei comandi permessa sul tuo sistema. Va usato con prudenza.</para
></listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Eseguibile</guilabel
></term>
<listitem
><para
>L'eseguibile principale nello script. Questo è obbligatorio, ed è usato per verificare se il comando può essere eseguito. È ammesso un percorso completamente qualificato nel caso in cui l'eseguibile non sia nella variabile d'ambiente <envar
>PATH</envar
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tipi di file</guilabel
></term>
<listitem
><para
>Un elenco separato da punti e virgola dei tipi MIME per cui questo comando dovrebbe essere abilitato.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Salva</guilabel
></term>
<listitem
><para
>Puoi scegliere di far salvare il documento attuale o tutti i documenti prima di eseguire lo script. Questo è utile se lo script legge il file dal disco.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nome della riga di comando</guilabel
></term>
<listitem
><para
>Se compili questo campo, lo strumento sarà disponibile dalla <link linkend="advanced-editing-tools-commandline"
>riga di comando dell'editor</link
> come <command
>exttool-<replaceable
>Nome della riga di comando</replaceable
></command
> (cioè la stringa che hai immesso qui, preceduta da <userinput
>exttool-</userinput
>).</para
></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--
Missing (according to config docs)
Additional pages for enabled plugins: 
Kate Snippets
Backtrace Browser
Symbol Viewer
-->
</chapter>
