<chapter id="xmltools">
<chapterinfo>

<title
>Completado de <acronym
>XML</acronym
></title>

<authorgroup>
<author
> <firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
><email
>daniel.naber@t-online.de</email
></address
> </affiliation
> </author>
</authorgroup>
<date
>2002-07-20</date>
<releaseinfo
>0.90.00</releaseinfo>
<abstract>

<para
>Este conector soporta la escritura de archivos XML a través del listado de las marcas permitidas y otras opciones.</para>

</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kate</keyword>
<keyword
>xml</keyword>
</keywordset>
</chapterinfo>

<title
>Introducción</title>

<para
>Este conector 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 (&eg; se muestran todas las entidades si el carácter a la izquierda del cursor es <quote
>&amp;</quote
>). Además es posible cerrar la marca sin cerrar más próxima por la izquierda.</para>

<para
>El <acronym
>DTD</acronym
> debe existir en formato XML, tal y como lo produce el programa de Perl <command
>dtdparse</command
>. Llamaremos a estos tipos de DTDs <quote
>meta DTDs</quote
>. Se proporcionan algunos meta DTDs. Están instalados en <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, que es además el directorio predeterminado cuando selecciona <guimenuitem
>Asignar Meta DTD...</guimenuitem
>. Para producir sus propios meta DTDs, descargue dtdparse de <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Cómo utilizarlo</title>

<para
>Inicie Kate y seleccione <guilabel
>Completado XML de Kate</guilabel
>, que aparece en la sección <guilabel
>Aplicación</guilabel
>/<guilabel
>Plugins</guilabel
> en el menú <menuchoice
><guimenu
>Opciones</guimenu
> <guimenuitem
>Configurar Kate...</guimenuitem
></menuchoice
>. Después de eso, seleccione <menuchoice
><guimenu
>Plugin XML</guimenu
><guimenuitem
>Asignar Meta DTD</guimenuitem
></menuchoice
>. Si su documento no contiene <quote
>DOCTYPE</quote
> o el tipo de documento es desconocido, tendrá que seleccionar un meta DTD desde el sistema de archivos. De otra forma, el meta DTD que coincida con el DOCTYPE del documento será cargado automáticamente.</para>

<para
>Ahora ya puede utilizar el conector mientras introduce texto:</para>

<variablelist
> <varlistentry
> <term
>&lt; (tecla menor que)</term
> <listitem
><para
>Esto abre una lista de posibles elementos salvo que el cursor ya esté dentro de una marca. Tenga en cuenta que en este momento no es posible utilizar esto para insertar un elemento del primer nivel (p.e. <quote
>&lt;html&gt;</quote
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
>" (tecla de comillas)</term
> <listitem
><para
>La tecla de comillas abrirá una lista con los posibles valores del atributo (si es que existen) si se encuentra dentro de una marca.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>(tecla de espacio)</term
> <listitem
><para
>Esta tecla abrirá una lista de posibles atributos para el elemento actual si se encuentra dentro de una marca.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>&amp; (tecla de ampersand)</term
> <listitem
><para
>Este tecla abrirá una lista de entidades nombradas.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Características y limitaciones</title>

<para
>Usted puede probar todas las funciones y limitaciones cargando <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> 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 conector.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Estructura de menús</title>

<variablelist
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Plugin XML</guimenu
> <guimenuitem
>Insertar elemento...</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>Esto abrirá un diálogo que le permite insertar un elemento de XML. Los caracteres &lt;,&gt; y la marca de cierre serán insertados automáticamente. Si tiene algún texto seleccionado al utilizar este menú, dicho texto será rodeados por las marcas 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ú <guimenuitem
>Asignar meta DTD...</guimenuitem
>. </para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Conector XML</guimenu
> <guimenuitem
>Cerrar elemento</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>Esto buscará en el texto una marca 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 se desplaza hacia la izquierda. Si no encuentra ninguna marca abierta no se realizará ninguna operación.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Conector XML</guimenu
> <guimenuitem
>Asignar Meta DTD...</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>Esto le comunica al conector qué meta DTD debe utilizar en todos los documentos abiertos. Tenga en cuenta que esta asignación no será almacenada y deberá repetirla la siguiente vez que inicie &kate;.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Agradecimientos</title>

<para
> Conector de &kate; <quote
>Completado de XML</quote
> copyright 2001,2002 Daniel Naber <email
>daniel.naber@t-online.de</email
>. </para>

<para
> Copyright de la documentación 2001,2002 Daniel Naber </para>

<para
>Traducido por Miguel Revilla Rodríguez <email
>yo@miguelrevilla.com</email
></para
> <para
>Traducido por José Cohen Cohen <email
>yosilnx@yahoo.com</email
></para
> 

<!-- &underFDL; -->
&underGPL;

</sect1>
</chapter>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->


