# Completamento &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 `$TDEDIR/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 apri la finestra di configurazione sotto Impostazioni Configura Kate.... Quindi seleziona Completamento di XML di Kate che apparirà nella sezione Applicazione/Plugin e chiudi la finestra. Quindi, seleziona XML Assegna meta-DTD.... Se il tuo documento non contiene nessun DOCTYPE, 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.

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.

& (e commerciale)

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

## Funzionalità e limiti

Puoi provare tutte le funzioni e limitazioni caricando `$TDEDIR/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

&Ctrl;Invio 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....

&Ctrl;< 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.

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

Copyright 2001,2002 della documentazione &Daniel.Naber;

Federico Zenithfederico.zenith@member.fsf.org

&underGPL;