<chapter id="xmltools"> <chapterinfo> <title >Completat &XML;</title> <authorgroup> <author ><firstname >Daniel</firstname > <surname >Naber</surname > <affiliation > <address >&Daniel.Naber.mail;</address> </affiliation> </author> </authorgroup > <date >17-05-2006</date > <releaseinfo >3.5.2</releaseinfo > <abstract > <para >Aquest connector suporta l'escriptura de fitxers &XML; a través del llistat de les etiquetes permeses i altres opcions.</para> </abstract> <keywordset> <keyword >KDE</keyword> <keyword >kate</keyword> <keyword >xml</keyword> </keywordset> </chapterinfo> <title >Introducció</title> <para >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 <quote >&</quote >). A més també és possible tancar l'etiqueta oberta més propera.</para> <para >La <acronym >DTD</acronym > haurà d'existir en format &XML;, tal i com la produeix el programa de Perl <command >dtdparse</command >. Direm a aquests tipus de DTD <quote >meta DTD</quote >. Es proveeixen algunes meta DTD. Estan instal·lades en <filename class="directory" >$KDEDIR/share/apps/katexmltools/</filename >, que a més és la carpeta per omissió quan escolliu <guimenuitem >Assigna la meta DTD...</guimenuitem >. Per a produir les vostres pròpies meta DTD, descarregueu <command >dtdparse</command > des de <ulink url="http://dtdparse.sourceforge.net" >http://dtdparse.sourceforge.net</ulink >.</para> <sect1 id="xmltools-how-to-use"> <title >Com usar-lo</title> <para >Inicieu &kate; i obriu el diàleg de configuració sota <menuchoice ><guimenu >Arranjament</guimenu > <guimenuitem >Configura Kate...</guimenuitem ></menuchoice >. Aleshores trieu <guilabel >Completat XML per a Kate</guilabel >, aquest apareixerà en la secció <guilabel >Aplicació</guilabel >/<guilabel >Connectors</guilabel > i tanqueu el diàleg. Després d'això, seleccioneu <menuchoice ><guimenu >XML</guimenu ><guimenuitem >Assigna la Meta DTD</guimenuitem ></menuchoice >. Si el vostre document no conté <quote >DOCTYPE</quote > 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.</para> <para >Ara podeu usar el connector mentre escriviu text:</para> <variablelist> <varlistentry> <term >< (clau menor que)</term> <listitem ><para >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; <quote ><html></quote >).</para ></listitem> </varlistentry> <varlistentry> <term >" (clau de cometes)</term> <listitem ><para >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.</para ></listitem> </varlistentry> <varlistentry> <term >(clau d'espai)</term> <listitem ><para >Aquesta clau obrirà una llista de possibles atributs per a l'element actual si us trobeu dins d'una etiqueta.</para> </listitem> </varlistentry> <varlistentry> <term >& (clau de 'i')</term> <listitem ><para >Aquest clau obrirà una llista d'entitats anomenades.</para ></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="xmltools-features-and-limitations"> <title >Característiques i limitacions</title> <para >Podeu provar totes les funcions i limitacions carregant <filename >$KDEDIR/share/apps/katexmltools/testcases.xml</filename > 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.</para> </sect1> <sect1 id="xmltools-menu"> <title >Estructura del menú</title> <variablelist> <varlistentry> <term> <menuchoice ><shortcut > <keycombo action="simul" >&Ctrl;&Retro;</keycombo > </shortcut > <guimenu >XML</guimenu > <guimenuitem >Insereix element...</guimenuitem > </menuchoice> </term> <listitem ><para >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ú <guimenuitem >Assigna la meta DTD...</guimenuitem >. </para ></listitem> </varlistentry> <varlistentry> <term> <menuchoice ><shortcut > <keycombo action="simul" >&Ctrl;<keycap ><</keycap ></keycombo > </shortcut > <guimenu >XML</guimenu > <guimenuitem >Tanca element</guimenuitem > </menuchoice> </term> <listitem ><para >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ó.</para ></listitem> </varlistentry> <varlistentry> <term> <menuchoice ><guimenu >XML</guimenu > <guimenuitem >Assigna la meta DTD...</guimenuitem > </menuchoice> </term> <listitem ><para >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;.</para ></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="xmltools-thanks-and-acknowledgements"> <title >Agraïments i reconèixements</title> <para >El connector <quote >Completat XML</quote > de &kate; copyright 2001,2002 de &Daniel.Naber; &Daniel.Naber.mail;. </para> <para >Documentació copyright 2001,2002 de &Daniel.Naber; </para> <para >Traductor de la documentació: &credits.Antoni.Bella;</para > &underGPL; </sect1> </chapter> <!-- Local Variables: mode: sgml sgml-omittag: nil sgml-shorttag: t End: -->