# Completamento di XML

## Introduzione

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 è &). È inoltre possibile chiudere il tag aperto più vicino a sinistra.

Il DTD deve esistere in un formato XML, come prodotto dal programma Perl `dtdparse`. Chiamiamo un DTD in questa forma un meta-DTD. Sono forniti alcuni meta-DTD. Sono installati in `$KDEDIR/share/apps/katexmltools/`, che è anche la cartella predefinita quando scegli Assegna meta-DTD.... Per produrre i tuoi meta-DTD, scarica `dtdparse` da http://dtdparse.sourceforge.net.

## Istruzioni per l'uso

Avvia Kate e seleziona Completamento di XML di Kate che apparirà nella sezione Applicazione/Plugin sotto Impostazioni Configura Kate.... Quindi, seleziona Plugin XML Assegna meta-DTD. Se il tuo documento non contiene nessun DOCTYPE, o se il doctype è ignoto, dovrai selezionare un meta-DTD dal sistema file. Altrimenti sarà caricato automaticamente il meta-DTD che corrisponde al DOCTYPE del documento corrente.

Puoi ora usare il plugin scrivendo il tuo testo:

< (minore)

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

" (virgolette)

- Le virgolette attiveranno un elenco di possibili valori di attributi (se ce ne sono) se sei all'interno di un tag.

(spazio)

- Lo spazio attiverà un elenco di attributi possibili per l'elemento attuale se sei all'interno di un tag.

& (ampersand)

- Questo tasto attiverà un elenco di nomi di entità.

## Funzionalità e limiti

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

## Struttura del menu

Plugin XML Inserisci elemento...

- 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 Assegna meta-DTD....

Plugin XML Chiudi elemento

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

Plugin XML Assegna meta-DTD...

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

## Ringraziamenti e riconoscimenti

Plugin di &kate; Completamento di XML copyright 2001,2002 Daniel Naber daniel.naber@t-online.de.

Copyright 2001,2002 della documentazione Daniel Naber

Federico Zenithzenith@chemeng.ntnu.no

&underGPL;