<chapter id="xmltools"> <chapterinfo> <title>&XML;-komplettering</title> <authorgroup> <author><firstname>Daniel</firstname> <surname>Naber</surname> <affiliation> <address>&Daniel.Naber.mail;</address> </affiliation> </author> </authorgroup> <date>2006-05-17</date> <releaseinfo>3.5.2</releaseinfo> <abstract> <para>Dette plugin understøtter at skrive &XML;-filer ved at give en liste af tilladte mærker og mere.</para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>kate</keyword> <keyword>xml</keyword> </keywordset> </chapterinfo> <title>Indledning</title> <para>Dette plugin giver vink om hvad der er tilladt på et bestemt sted i en &XML;-fil, ifølge filens DTD. Det vil give en liste af mulige elementer, attributter, attribut-værdier eller entiteter, afhængig af markørens aktuelle position (⪚ er alle entiteter på en liste hvis tegnet til venstre for markøren er <quote>&</quote>). Det er også muligt at lukke det nærmeste åbne mærke til venstre.</para> <para><acronym>DTD</acronym>'en skal findes i &XML;-format, som produceret af Perl-programmet <command>dtdparse</command>. Vi vil kalde en DTD i dette en <quote>meta-DTD</quote>. Nogle meta-DTD'er medfølger. De er installerede i <filename class="directory">$TDEDIR/share/apps/katexmltools/</filename>, som også er standardmappen når du vælger <guimenuitem>Tilknyt Meta-DTD...</guimenuitem>. For at producere dine egne meta-DTD'er, skal du have <command>dtdparse</command> fra <ulink url="http://dtdparse.sourceforge.net">http://dtdparse.sourceforge.net</ulink>.</para> <sect1 id="xmltools-how-to-use"> <title>Hvordan bruges det</title> <para>Start &kate; og åbn indstillingsdialogen med <menuchoice><guimenu>Opsætning</guimenu> <guimenuitem>Indstil &kate;...</guimenuitem></menuchoice>. Markér derefter <guilabel>Kate XML-komplettering</guilabel>, som vises i afsnittet <guilabel>Program</guilabel> <guilabel>Plugin</guilabel>. Vælg derefter <menuchoice><guimenu>XML</guimenu> <guimenuitem>Tilknyt meta-DTD...</guimenuitem></menuchoice>. Hvis dokumentet ikke indeholder en <quote>doctype</quote> eller en ukendt doctype, skal du vælge en meta-DTD i filsystemet. Ellers så indlæses den meta-DTD som hører sammen med det nuværende dokuments doctype automatisk.</para> <para>Du kan nu bruge dette plugin mens du skriver din tekst:</para> <variablelist> <varlistentry> <term>< (mindre end-tasten) </term> <listitem><para>Dette vil udløse en liste af mulige elementer, med mindre markøren allerede er indeni et mærke. Bemærk at du ikke for øjeblikket kan bruge dette til at indsætte topniveau-elementet (f.eks. <quote><html></quote>).</para></listitem> </varlistentry> <varlistentry> <term>" (citationstegn-tast)</term> <listitem><para>Citationstasten vil udløse en liste af mulige attributværdier (hvis der er nogen) hvis du er indeni et mærke.</para></listitem> </varlistentry> <varlistentry> <term>(mellemrumstast)</term> <listitem><para>Denne tast vil udløse en liste af mulige attributter for det aktuelle element hvis du er indeni et mærke.</para> </listitem> </varlistentry> <varlistentry> <term>& (ét-tasten)</term> <listitem><para>Denne tast vil udløse en liste af navngivne entiteter.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="xmltools-features-and-limitations"> <title>Egenskaber og begrænsninger</title> <para>Du kan teste alle funktioner og begrænsninger ved at indlæse <filename>$TDEDIR/share/apps/katexmltools/testcases.xml</filename> i &kate; og følge instruktionerne. Bemærk at arbejde med mere end en visning pr dokument endnu ikke er understøttet rigtigt af dette plugin. </para> </sect1> <sect1 id="xmltools-menu"> <title>Menustruktur</title> <variablelist> <varlistentry> <term> <menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Retur</keycap> </keycombo> </shortcut> <guimenu>XML</guimenu> <guimenuitem>Indsæt element...</guimenuitem> </menuchoice> </term> <listitem><para>Dette vil åbne en dialog der lader indsætte et &XML;-element. <-, >-tegnene og afslutningsmærket vil blive indsat automatisk. Hvis du har markeret tekst når dette menupunkt er valgt, vil den markerede tekst blive omgivet af åbnings- og afslutningsmærket. Dialogen tilbyder også komplettering af alle elementer der kan indsættes ved den aktuelle markørposition hvis du har tilknyttet en meta-DTD ved brug af <guimenuitem>Tilknyt Meta-DTD...</guimenuitem>. </para></listitem> </varlistentry> <varlistentry> <term> <menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap><</keycap></keycombo> </shortcut> <guimenu>XML</guimenu> <guimenuitem>Afslut element</guimenuitem> </menuchoice> </term> <listitem><para>Dette vil gennemsøge din tekst for et mærke, der endnu ikke er lukket og vil lukke det ved at indsætte det tilsvarende lukke-mærke. Søgningen starter ved markørens position og går til venstre. Hvis den ikke kan finde et åbent mærke så vil ingenting ske.</para></listitem> </varlistentry> <varlistentry> <term> <menuchoice><guimenu>XML</guimenu> <guimenuitem>Tilknyt meta-DTD...</guimenuitem> </menuchoice> </term> <listitem><para>Dette vil fortælle dette plugin hvilket meta-DTD der skal bruges for det aktuelle dokumenter. Bemærk at denne tilknytning ikke vil blive gemt. Du vil skulle gentage det når du starter &kate; næste gang.</para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="xmltools-thanks-and-acknowledgements"> <title>Tak og anerkendelser</title> <para>&kate;-plugin <quote>XML-Komplettering</quote> ophavsret 2001,2002 ved &Daniel.Naber; &Daniel.Naber.mail;. </para> <para>Dokumentation ophavsret 2001,2002 &Daniel.Naber; </para> &erik.kjaer.pedersen.credit; &underGPL; </sect1> </chapter> <!-- Local Variables: mode: sgml sgml-omittag: nil sgml-shorttag: t End: -->