# XML-Vervollständigung

Daniel
Naber

    daniel.naber@t-online.de

2002-07-20
0.90.00

Dieses Plugin unterstützt die Erstellung von XML-Dateien, indem es erlaubte Marken anzeigt und einige zusätzliche Informationen liefert.

KDE
kate
xml

# Einleitung

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 & ist). Es ist außerdem möglich, die nächste linksseitige nicht-geschlossene Marke zu schließen.

Die DTD muss im XML-Format vorliegen, wie es das Perl-Programm `dtdparse` liefert. Eine DTD mit diesem Format wird als Meta-DTD bezeichnet. Einige Meta-DTDs werden mitgeliefert. Sie befinden sich im Verzeichnis `$KDEDIR/share/apps/katexmltools/`, welches auch Standardverzeichnis für den Menü-Befehl Meta-DTD zuweisen... ist. Um eigene Meta-DTDs zu erzeugen benötigt man `dtdparse` von http://dtdparse.sourceforge.net.

## Wie es benutzt wird

Starten Sie Kate und wählen Sie Kate XML-Vervollständigung im Abschnitt Anwendung/Plugins aus dem Menü Einstellungen Kate Einrichten.... Danach wählen Sie XML-Plugin Meta-DTD zuweisen....

Das Plugin kann jetzt während der Texteingabe benutzt werden.

< ("Kleiner als"-Taste)

  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. <html>).

" (Anführungszeichen)

  Die Eingabe des Anführungszeichens innerhalb einer Marke wird eine Liste mit möglichen Attributwerten hervorbringen (wenn es welche gibt).

(Leertaste)

  Diese Taste wird eine Liste mit möglichen Attributen für das aktuelle Element hervorbringen, wenn sie innerhalb einer Marke gedrückt wird.

& (Kaufmanns-Und)

  Diese Taste wird eine Liste mit definierten Entitäten hervorbringen.

## Funktionen und Einschränkungen

Man kann alle Funktionen und Einschränkungen testen, indem man die Datei `$KDEDIR/share/apps/katexmltools/testcases.xml` in &kate; lädt und den Anweisungen folgt. Beachten Sie, dass die Arbeit mit mehreren Ansichten pro Dokument noch nicht fehlerfrei unterstützt wird.

## Menü-Struktur

XML-Plugin Element einfügen...

  Dies öffnet einen Dialog zum Einfügen eines XML-Elementes. Die <,>-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 Meta-DTD zuweisen... zugewiesen wurde.

XML-Plugin Element schließen

  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.

XML-Plugin Meta-DTD zuweisen...

  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.

## Danksagungen

&kate;-Plugin XML-Vervollständigung Copyright 2001, 2002 Daniel Naber daniel.naber@t-online.de.

Copyright der Dokumentation 2001, 2002 Daniel Naber

Übersetzung: Frank Schütte F.Schuette@t-online.de

Überarbeitung der Übersetzung: Andreas Kunadt kunsen@web.de

&underGPL;