tde-i18n/tde-i18n-it/docs/tdeaddons/kate-plugins/xmltools.docbook

<chapter id="xmltools">
<chapterinfo>

<title>Completamento &XML;</title>

<authorgroup>
<author><firstname>Daniel</firstname> <surname>Naber</surname> <affiliation> <address>&Daniel.Naber.mail;</address>
</affiliation>
</author>
</authorgroup> <date>2006-05-17</date> <releaseinfo>3.5.2</releaseinfo> <abstract> <para>Questo plugin supporta la scrittura di file &XML; elencando i tag permessi e altro.</para>

</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>kate</keyword>
<keyword>xml</keyword>
</keywordset>
</chapterinfo>

<title>Introduzione</title>

<para>Questo plugin dà suggerimenti su cosa sia permesso in una certa posizione in un file &XML;, secondo il DTD del file. Elencherà elementi, attributi, valori di attributi ed entità possibili, a seconda della posizione del cursore (per esempio tutte le entità sono elencate se il carattere alla sinistra del cursore è <quote>&amp;</quote>). È inoltre possibile chiudere il tag aperto più vicino a sinistra.</para>

<para>Il <acronym>DTD</acronym> deve esistere in un formato &XML;, come prodotto dal programma Perl <command>dtdparse</command>. Chiamiamo un DTD in questa forma un <quote>meta-DTD</quote>. Sono forniti alcuni meta-DTD. Sono installati in <filename class="directory">$TDEDIR/share/apps/katexmltools/</filename>, che è anche la cartella predefinita quando scegli <guimenuitem>Assegna meta-DTD...</guimenuitem>. Per produrre i tuoi meta-DTD, scarica <command>dtdparse</command> da <ulink url="http://dtdparse.sourceforge.net">http://dtdparse.sourceforge.net</ulink>.</para>

<sect1 id="xmltools-how-to-use">
<title>Istruzioni per l'uso</title>

<para>Avvia &kate; e apri la finestra di configurazione sotto <menuchoice><guimenu>Impostazioni</guimenu><guimenuitem>Configura Kate...</guimenuitem></menuchoice>. Quindi seleziona <guilabel>Completamento di XML di Kate</guilabel> che apparirà nella sezione <guilabel>Applicazione</guilabel>/<guilabel>Plugin</guilabel> e chiudi la finestra. Quindi, seleziona <menuchoice><guimenu>XML</guimenu><guimenuitem>Assegna meta-DTD...</guimenuitem></menuchoice>. Se il tuo documento non contiene nessun <quote>DOCTYPE</quote>, o se il doctype è ignoto, dovrai selezionare un meta-DTD dal filesystem. Altrimenti, sarà caricato automaticamente il meta-DTD che corrisponde al DOCTYPE del documento corrente.</para>

<para>Puoi ora usare il plugin scrivendo il tuo testo:</para>

<variablelist>

<varlistentry>
<term>&lt; (minore)</term>
<listitem><para>Questo attiverà un elenco di elementi possibili, a meno che il cursore sia già dentro un tag. Nota come non lo si possa usare per inserire l'elemento di livello massimo (per esempio <quote>&lt;html&gt;</quote>).</para></listitem>
</varlistentry>

<varlistentry>
<term>" (virgolette)</term>
<listitem><para>Le virgolette attiveranno un elenco di possibili valori di attributi (se ce ne sono) se sei all'interno di un tag.</para></listitem>
</varlistentry>

<varlistentry>
<term>(spazio)</term>
<listitem><para>Lo spazio attiverà un elenco di attributi possibili per l'elemento attuale se sei all'interno di un tag.</para>
</listitem>
</varlistentry>

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

</sect1>

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

<para>Puoi provare tutte le funzioni e limitazioni caricando <filename>$TDEDIR/share/apps/katexmltools/testcases.xml</filename> in &kate; e seguendo le istruzioni. Nota come il lavoro con più di una vista per documento non sia ancora supportato da questo plugin.</para>

</sect1>


<sect1 id="xmltools-menu">
<title>Struttura del menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Invio</keycap></keycombo> </shortcut> <guimenu>XML</guimenu> <guimenuitem>Inserisci elemento...</guimenuitem> </menuchoice>
</term>
<listitem><para>Questo aprirà una finestra di dialogo che ti permetterà di inserire un elemento &XML;. I caratteri &lt;, &gt; e il tag di chiusura saranno inseriti automaticamente. Se hai selezionato del testo quando questo elemento del menu viene selezionato, il testo selezionato verrà circondato dai tag di apertura e chiusura. La finestra di dialogo offre anche un completamento di tutti gli elementi che potrebbero venire inseriti alla posizione attuale del cursore se hai assegnato un meta-DTD usando <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 tuo testo un tag che non sia ancora chiuso, e lo chiuderà inserendo il tag di chiusura corrispondente. La ricerca inizia alla posizione del cursore e va verso sinistra. Se non può trovare un tag di apertura non succederà nulla.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><guimenu>XML</guimenu> <guimenuitem>Assegna meta-DTD...</guimenuitem> </menuchoice>
</term>
<listitem><para>Questo dirà al plugin quale meta-DTD usare per il documento attuale. Nota come questa assegnazione non sarà salvata. Dovrai ripeterla quando avvierai &kate; la prossima volta.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title>Ringraziamenti e riconoscimenti</title>

<para>Plugin di &kate; <quote>Completamento di XML</quote> copyright 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>

<para>Copyright 2001,2002 della documentazione &Daniel.Naber; </para>

<para>Federico Zenith<email>federico.zenith@member.fsf.org</email></para> 
&underGPL; </sect1>
</chapter>