# Completamento &XML;

Daniel
Naber

    &Daniel.Naber.mail;

2006-05-17
3.5.2

Questo plugin supporta la scrittura di file &XML; elencando i tag permessi e altro.

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

& (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

&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 Zenithzenith@chemeng.ntnu.no

&underGPL;