<chapter id="xmltools">
<chapterinfo>

<title
><acronym
>XML</acronym
>-Vervollständigung</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
>Dieses Plugin unterstützt die Erstellung von XML-Dateien, indem es erlaubte Marken anzeigt und einige zusätzliche Informationen liefert.</para>

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

<title
>Einleitung</title>

<para
>Dieses Plugin gibt Hinweise, was an einer bestimmten Stelle einer XML-Datei, der zugehörigen DTD entsprechend, erlaubt ist. Es zeigt, abhängig von der Cursorposition, mögliche Elemente, Attribute, Attributwerte oder Entitäten an (&zb; werden alle Entitäten angezeigt, wenn das Zeichen links vom Cursor <quote
>&amp;</quote
> ist). Es ist außerdem möglich, die nächste linksseitige nicht-geschlossene Marke zu schließen.</para>

<para
>Die <acronym
>DTD</acronym
> muss im XML-Format vorliegen, wie es das Perl-Programm <command
>dtdparse</command
> liefert. Eine DTD mit diesem Format wird als <quote
>Meta-DTD</quote
> bezeichnet. Einige Meta-DTDs werden mitgeliefert. Sie befinden sich im Ordner <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, der auch Standardordner für den Menü-Befehl <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> ist. Um eigene Meta-DTDs zu erzeugen, benötigen Sie <command
>dtdparse</command
> von <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Wie es benutzt wird</title>

<para
>Starten Sie Kate und wählen Sie <guilabel
>XML-Vervollständigung</guilabel
> im Abschnitt <guilabel
>Programm</guilabel
>/<guilabel
>Erweiterungen</guilabel
> aus dem Menü <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Kate einrichten ...</guimenuitem
></menuchoice
>. Danach wählen Sie <menuchoice
><guimenu
>XML</guimenu
><guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
></menuchoice
>.</para>

<para
>Das Plugin kann jetzt während der Texteingabe benutzt werden.</para>

<variablelist>

<varlistentry>
<term
>&lt; ("Kleiner als"-Taste)</term>
<listitem
><para
>Dies wird eine Liste mit möglichen Elementen hervorbringen, solange sich der Cursor nicht schon in einer Marke befindet. Beachten Sie, dass Sie dies derzeitig noch nicht benutzen können, um ein Element aus der obersten Ebene einzufügen (z.B. <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>" (Anführungszeichen)</term>
<listitem
><para
>Die Eingabe des Anführungszeichens innerhalb einer Marke wird eine Liste mit möglichen Attributwerten hervorbringen (wenn es welche gibt).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>(Leertaste)</term>
<listitem
><para
>Diese Taste wird eine Liste mit möglichen Attributen für das aktuelle Element hervorbringen, wenn sie innerhalb einer Marke gedrückt wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>&amp; (Kaufmanns-Und)</term>
<listitem
><para
>Diese Taste wird eine Liste mit definierten Entities hervorbringen.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Funktionen und Einschränkungen</title>

<para
>Sie können alle Funktionen und Einschränkungen testen, indem Sie die Datei <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> in &kate; laden und den Anweisungen folgen. Beachten Sie, dass die Arbeit mit mehreren Ansichten pro Dokument noch nicht fehlerfrei unterstützt wird.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Menü-Struktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Element einfügen ...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Dies öffnet einen Dialog zum Einfügen eines XML-Elementes. Die &lt;,&gt;-Zeichen und die schließende Marke werden automatisch eingefügt. Wenn vorher Text markiert war, wird dieser von einer öffnenden und einer schließenden Marke umgeben werden. Mit dem Dialog ist es auch möglich, alle an der Cursor-Position eingegebenen Elemente zu vervollständigen, wenn eine Meta-DTD mittels <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> zugewiesen wurde. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Element schließen</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Sucht im Text nach einer Marke, die noch nicht geschlossen wurde und schließt diese durch Einfügen der entsprechenden schließenden Marke. Die Suche erfolgt von der Cursorposition aus nach links. Falls keine offene Marke gefunden wird, wird nichts gemacht.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Meta-DTD zuweisen ...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Teilt dem Plugin mit, welche Meta-DTD für das aktuelle Dokument verwendet werden soll. Beachten Sie, dass diese Zuordnung nicht gespeichert wird. Sie muss beim nächsten Programmstart von &kate; wiederholt werden.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

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

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

<para
>Copyright der Dokumentation 2001, 2002 Daniel Naber </para>

<para
>Übersetzung: Frank Schütte <email
>F.Schuette@t-online.de</email
></para
> <para
>Überarbeitung der Übersetzung: Andreas Kunadt <email
>kunsen@web.de</email
></para
> 
&underGPL; </sect1>
</chapter>

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

