<chapter id="xmltools">
<chapterinfo>

<title>&XML;-Vervollständigung</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>Dieses Modul 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 Modul gibt Hinweise, was an einer bestimmten Stelle einer &XML;-Datei gemäß der zugehörigen DTD erlaubt ist. Es zeigt, abhängig von der Cursorposition, mögliche Elemente, Attribute, Attributwerte oder Entitäten an (&eg; 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">$TDEDIR/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>Anwendung</title>

<para>Starten Sie &kate; und öffnen Sie den Einrichtungsdialog mit <menuchoice><guimenu>Einstellungen</guimenu> <guimenuitem>&kate; einrichten ...</guimenuitem></menuchoice>. Dann wählen Sie <guilabel>XML-Vervollständigung</guilabel> im Abschnitt <guilabel>Programm</guilabel> <guilabel>Erweiterungen</guilabel>. Danach wählen Sie <menuchoice><guimenu>XML</guimenu><guimenuitem>Meta-DTD zuweisen ...</guimenuitem></menuchoice>. Wenn Ihr Dokument keinen <quote>DOCTYPE</quote> enthält oder dieser unbekannt ist, wählen Sie eine Meta-DTD aus Ihrem Dateisystem. Ansonsten wird die passende Meta-DTD für Ihr aktuelles Dokument automatisch geladen.</para>

<para>Das Modul können Sie kann jetzt während der Texteingabe benutzen.</para>

<variablelist>

<varlistentry>
<term>&lt; ("Kleiner als"-Taste)</term>
<listitem><para>Damit wird eine Liste mit möglichen Elementen angezeigt, 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 (&eg; <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 anzeigen (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 anzeigen, wenn die Taste 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 anzeigen.</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>$TDEDIR/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><shortcut> <keycombo action="simul">&Ctrl;<keycap>Eingabe</keycap> </keycombo> </shortcut> <guimenu>XML</guimenu> <guimenuitem>Element einfügen ...</guimenuitem> </menuchoice>
</term>
<listitem><para>Damit öffnen Sie 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 mit einer öffnenden und einer schließenden Marke umgeben. 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><shortcut> <keycombo action="simul">&Ctrl;<keycap>&lt;</keycap></keycombo> </shortcut> <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, hat dieser Befehl keine Auswirkungen.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><guimenu>XML</guimenu> <guimenuitem>Meta-DTD zuweisen ...</guimenuitem> </menuchoice>
</term>
<listitem><para>Bestimmt die Meta-DTD für das aktuelle Dokument. 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;-Modul <quote>XML-Vervollständigung</quote> Copyright 2001, &Daniel.Naber; &Daniel.Naber.mail;. </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>
