# Completado &XML;

## Introducción

Este complemento proporciona ayuda sobre lo que está permitido en un punto determinado de un archivo &XML;, en función del DTD del archivo. Mostrará una lista de posibles elementos, atributos, valores de atributos o entidades, dependiendo de la posición del cursor (⪚ se muestran todas las entidades si el caracter a la izquierda del cursor es «&»). Además es posible cerrar la etiqueta abierta más próxima.

El DTD debe existir en formato &XML;, tal y como lo produce el programa de Perl `dtdparse`. Llamaremos a estos tipos de DTDs «meta DTDs». Se proporcionan algunos meta DTDs. Están instalados en `$TDEDIR/share/apps/katexmltools/`, que es además la carpeta predeterminada cuando se selecciona Asignar meta DTD.... Para producir sus propios meta DTDs, descargue `dtdparse` de http://dtdparse.sourceforge.net.

## Cómo utilizarlo

Inicie &kate; y abra el diálogo de configuración, al que podrá acceder a través de Preferencias Configurar &kate;.... A continuación seleccione Completado XML de Kate, que aparece en la sección Aplicación/Complementos y cierre el diálogo. A continuación seleccione XML Asignar Meta DTD. Si su documento no contiene «DOCTYPE» o el tipo de documento es desconocido, tendrá que seleccionar un meta DTD desde el sistema de archivos. Si ésto no es así se cargará automáticamente el meta DTD que coincida con el DOCTYPE.

Ahora ya puede utilizar el complemento mientras introduce texto:

< (tecla menor que)

- Abre una lista de posibles elementos salvo que el cursor ya esté dentro de una etiqueta. Tenga en cuenta que en ese momento no será posible utilizar esta tecla para insertar un elemento del primer nivel (⪚ «<html>»).

" (tecla de comillas)

- La tecla de comillas abrirá una lista con los posibles valores del atributo (si es que existen) si se encuentra dentro de una etiqueta.

(tecla de espacio)

- Esta tecla abrirá una lista de posibles atributos para el elemento actual si se encuentra dentro de una etiqueta.

& (tecla de ampersand)

- Este tecla abrirá una lista de entidades nombradas.

## Características y limitaciones

Puede probar todas las funciones y limitaciones cargando `$TDEDIR/share/apps/katexmltools/testcases.xml` en &kate; y siguiendo las instrucciones. Tenga en cuenta que trabajar con más de una vista por documento no está todavía correctamente soportado por este complemento.

## Estructura de menús

&Ctrl;Entrar XML Insertar elemento...

- Abrirá un diálogo que le permitirá insertar un elemento de &XML;. Los caracteres <,> y la etiqueta de cierre serán insertados automáticamente. Si tiene algún texto seleccionado al utilizar este menú, dicho texto será rodeado por las etiquetas de apertura y cierre. El diálogo también ofrece completado de todos los elementos que pueden ser insertados en la posición actual del cursor si se ha asignado un meta DTD mediante el menú Asignar meta DTD....

&Ctrl;< XML Cerrar elemento

- Buscará en el texto una etiqueta que aún no esté cerrada y la cerrará insertando la marca de cierre correspondiente. La búsqueda comienza en la posición del cursor y continúa hacia la izquierda. Si no encuentra ninguna etiqueta abierta no se realizará ninguna operación.

XML Asignar meta DTD...

- Le comunica al complemento qué meta DTD debe utilizar en todos los documentos abiertos. Tenga en cuenta que esta asignación no será almacenada y deberá repetirla la próxima vez que inicie &kate;.

## Agradecimientos y reconocimientos

Derechos de autor del complemento de &kate; «Completado de XML». 2001, 2002. &Daniel.Naber; &Daniel.Naber.mail;.

Derechos de autor de la documentación. 2001, 2002. &Daniel.Naber;.

Traducido por Rafael Osuna rosuna@wol.es.

Traducido por Miguel Revilla Rodríguez yo@miguelrevilla.com.

Traducido por José Cohen Cohen yosilnx@yahoo.com.

Traducido por Santiago Fernández Sancho santi@kde-es.org.

&underGPL;