diff options
Diffstat (limited to 'tde-i18n-it/docs/tdeaddons/kate-plugins/xmltools.docbook')
| -rw-r--r-- | tde-i18n-it/docs/tdeaddons/kate-plugins/xmltools.docbook | 242 |
1 files changed, 242 insertions, 0 deletions
diff --git a/tde-i18n-it/docs/tdeaddons/kate-plugins/xmltools.docbook b/tde-i18n-it/docs/tdeaddons/kate-plugins/xmltools.docbook new file mode 100644 index 00000000000..3dabacaa61a --- /dev/null +++ b/tde-i18n-it/docs/tdeaddons/kate-plugins/xmltools.docbook @@ -0,0 +1,242 @@ +<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 +>&</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" +>$KDEDIR/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 +>< (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 +><html></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 +>& (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 +>$KDEDIR/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 <, > 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 +><</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> + +<!-- +Local Variables: +mode: sgml +sgml-omittag: nil +sgml-shorttag: t +End: +--> + |