# Completat &XML;

## Introducció

Aquest connector dona consells sobre el que està permès en una posició determinada d'un fitxer &XML;, en funció de la DTD del fitxer. Mostrarà una llista de possibles elements, atributs, valors d'atribut o entitats, depenent de la posició del cursor (&pex; es llisten totes les entitats si el caràcter a l'esquerra del cursor és &). A més també és possible tancar l'etiqueta oberta més propera.

La DTD haurà d'existir en format &XML;, tal i com la produeix el programa de Perl `dtdparse`. Direm a aquests tipus de DTD meta DTD. Es proveeixen algunes meta DTD. Estan instal·lades en `$TDEDIR/share/apps/katexmltools/`, que a més és la carpeta per omissió quan escolliu Assigna la meta DTD.... Per a produir les vostres pròpies meta DTD, descarregueu `dtdparse` des de http://dtdparse.sourceforge.net.

## Com usar-lo

Inicieu &kate; i obriu el diàleg de configuració sota Arranjament Configura Kate.... Llavores trieu Completat XML per a Kate, aquest apareixerà en la secció Aplicació/Connectors i tanqueu el diàleg. Després d'això, seleccioneu XML Assigna la Meta DTD. Si el vostre document no conté DOCTYPE o el tipus de document és desconegut, haureu de seleccionar una meta DTD des del sistema de fitxers. D'altra manera es carregarà automàticament la meta DTD que coincideixi amb el DOCTYPE.

Ara podeu usar el connector mentre escriviu text:

< (clau menor que)

- Obre una llista de possibles elements a menys que el cursor estigui dintre d'una etiqueta. Tingueu present que en aquest moment no serà possible usar-la per inserir un element de primer nivell (&pex; <html>).

" (clau de cometes)

- La clau de cometes obrirà una llista amb els possibles valors de l'atribut (si es que n'hi han) si us trobeu dins d'una etiqueta.

(clau d'espai)

- Aquesta clau obrirà una llista de possibles atributs per a l'element actual si us trobeu dins d'una etiqueta.

& (clau de 'i')

- Aquest clau obrirà una llista d'entitats anomenades.

## Característiques i limitacions

Podeu provar totes les funcions i limitacions carregant `$TDEDIR/share/apps/katexmltools/testcases.xml` en &kate; i seguint les instruccions. Tingueu present que treballar amb més d'una vista per document encara no està correctament suportat per aquest connector.

## Estructura del menú

&Ctrl;&Retro; XML Insereix element...

- Obrirà un diàleg que us permetrà inserir un element &XML;. Els caràcters <, > i l'etiqueta de tanca seran inserits automàticament. Si teniu algun text seleccionat en usar aquest menú, dit text serà envoltat per les etiquetes d'obrir i tancar. El diàleg també ofereix completat de tots els elements que es poden inserir en la posició actual del cursor si heu assignat una meta DTD mitjançant el menú Assigna la meta DTD....

&Ctrl;< XML Tanca element

- Cercarà en el text una etiqueta que encara no estigui tancada i la tancarà inserint la marca de tanca corresponent. La recerca comença en la posició del cursor i continuarà cap a l'esquerra. Si no troba cap etiqueta oberta no es realitzarà cap operació.

XML Assigna la meta DTD...

- Li diu al connector quina meta DTD usar en tots els documents actuals. Tingueu present que aquesta assignació no serà desada. Pel que haureu de repetir-la la propera vegada que inicieu &kate;.

## Agraïments i reconèixements

El connector Completat XML de &kate; copyright 2001,2002 de &Daniel.Naber; &Daniel.Naber.mail;.

Documentació copyright 2001,2002 de &Daniel.Naber;

Traductor de la documentació: &credits.Antoni.Bella;

&underGPL;