<chapter id="xmltools">
<chapterinfo>

<title
><acronym
>XML</acronym
>-aanvulling</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
>Deze plugin ondersteunt het schrijven van XML-tags middels het aanleveren van toegestane tags en meer.</para>

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

<title
>Inleiding</title>

<para
>Deze plugin geeft tips over wat toegestaan is op een bepaalde positie in een XML-bestand, volgens het DTD van het bestand. Het geeft een lijst met mogelijke elementen, attributen, attribuutwaarden of entiteiten, afhankelijk van de cursorpositie (&eg; alle intiteiten worden opgesomd als het karakter aan de linkerzijde van de cursor <quote
>&amp;</quote
> is). Het is ook mogelijk om de dichstbijzijnde geopende tag links van de cursor te sluiten.</para>

<para
>De <acronym
>DTD</acronym
> dient te bestaan in XML-formaat, zoals geproduceerd wordt door het Perl-programma <command
>dtdparse</command
>. We zullen een DTD in dit formaat <quote
>meta-DTD</quote
> noemen. Enkele meta-DTD's worden reeds aangeleverd. Ze zijn geïnstalleerd in <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>. Dit is ook de standaardmap als u <guimenuitem
>Meta-DTD toewijzen...</guimenuitem
> selecteert. Om uw eigen meta-DTD's te kunnen produceren, download <command
>dtdparse</command
> van <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Hoe te gebruiken</title>

<para
>Start Kate en selecteer <guilabel
>Kate XML-aanvulling</guilabel
> in de sectie <guilabel
>Applicatie</guilabel
>/<guilabel
>Plugins</guilabel
>. van Kate's configuratiedialoogvenster. U kunt het dialoogvenster openen via <menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Kate instellen...</guimenuitem
></menuchoice
>. Selecteer hierna <menuchoice
><guimenu
>XML-plugin</guimenu
><guimenuitem
>Meta-DTD toewijzen</guimenuitem
></menuchoice
>. Als uw document geen <quote
>DOCTYPE</quote
> bevat, of de doctype onbekend is, selecteer dan een meta-DTD van uw harde schijf. Anders zal de meta-DTD die overeenkomt met de huidige DOCTYPE van het document automatisch worden geladen.</para>

<para
>U kunt nu de plugin gebruiken terwijl u uw tekst intypt:</para>

<variablelist
> <varlistentry
> <term
>&lt; (minder dan-toets)</term
> <listitem
><para
>Deze toets zal een lijst met mogelijke elementen openen, tenzij de cursor zich reeds binnen een tag bevindt. Opmerking: u kunt dit momenteel niet gebruiken om een topniveau-element in te voeren (bijv. <quote
>&lt;html&gt;</quote
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
>" (aanhalingstoets)</term
> <listitem
><para
>De aanhalingstoets zal een lijst met mogelijke attribuutwaarden openen (als die er zijn) als u zich binnen een tag bevindt.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>(spatietoets)</term
> <listitem
><para
>Deze toets zal een lijst met mogelijke attributen voor het huidige element openen als u zich binnen een tag bevindt.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>&amp; (ampersandtoets)</term
> <listitem
><para
>Deze toets zal een lijst met benoemde entiteiten openen.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Functies en beperkingen</title>

<para
>U kunt alle mogelijkheden en beperkingen testen door <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> in &kate; te laden en de instructies op te volgen. Opmerking: het werken met meer dan een weergave per document wordt momenteel niet correct ondersteund door deze plugin.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Menustructuur</title>

<variablelist
> <varlistentry
> <term
> <menuchoice
> <guimenu
>XML-plugin</guimenu
> <guimenuitem
>Element invoegen...</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>Dit zal een dialoogvenster openen waarmee u een XML-element kunt invoegen. De karakters &lt;,&gt; en de afsluitende tag zullen automatisch worden ingevoegd. Als u tekst hebt geselecteerd voordat u dit menu-item selecteerde, dan zal deze tekst worden omgeven door de openingstag en afsluitende tag. Als u een meta-DTD hebt toegewezen via <guimenuitem
>Assign Meta DTD...</guimenuitem
> dan biedt het dialoogvenster ook het aanvullen van alle elementen die kunnen worden ingevoegd op de huidige cursorpositie  </para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>XML-plugin</guimenu
> <guimenuitem
>Element sluiten</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>Dit zal uw tekst doorzoeken op tags die nog niet zijn afgesloten en zal deze afsluiten door de bijhorende afsluitende tag in te voegen. De zoekactie begint bij de cursorpositie en gaat naar links. Als er geen openingstag gevonden wordt gebeurt er verder niets.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>XML-plugin</guimenu
> <guimenuitem
>Meta-DTD toewijzen...</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>Dit zal de plugin vertellen welk meta-DTD zal worden gebruikt voor het huidige document. Opmerking: deze toewijzing zal niet worden opgeslagen. U dient ze dus te herhalen als u &kate; de volgende keer opstart.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Bedankingen en erkenningen</title>

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

<para
> Documentatie: copyright 2001,2002 Daniel Naber </para>

&meld.fouten;&vertaling.niels;&vertaling.rinse31;

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

</sect1>
</chapter>

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


