# XML-aanvulling

Daniel
Naber

    daniel.naber@t-online.de

2002-07-20
0.90.00

Deze plugin ondersteunt het schrijven van XML-bestanden door het aanbieden van een lijst met toegestande tags en meer.

KDE
kate
xml

# Inleiding

Deze plugin geeft aan de hand van het bijhorende DTD hints over wat is toegestaan op een bepaalde positie in een XML-bestand. Ze biedt een lijst met mogelijke elementen, attributen, atribuurwaarden of entiteiten, afhankelijk van de cursorpositie. Zo worden bijvoorbeeld alle entiteiten getoond als het teken links van de cursor een & is. Het is ook mogelijk om de dichtsbijzijnde geopende tag links van de cursor te sluiten.

DE DTD dient aan wezig te zijn in XML-opmaak, zoals wordt aangemaakt door het Perl-programma `dtdparse`. We zullen een DTD in deze opmaak een meta-DTD noemen. Sommige meta-DTD's worden meegeleverd met KDE. U kunt ze vinden in de map `$KDEDIR/share/apps/katexmltools/`. Dit is ook de standaardmap als u kiest voor Meta-DTD toewijzen. Om uw eigen meta-DTD's aan te maken, installeer het programma `dtdparse` van http://dtdparse.sourceforge.net.

## Hoe te gebruiken

Start &kate; en selecteer menuoptie Instellingen Kate instellen.... In de dialoog die wordt geopend kiest u vervolgens de sectie Toepassing Plugins. Selecteer in deze sectie XML-aanvulling en bevestig uw keuze. Selecteer nu in het hoofdvenster van &kate; de menuoptie XML Meta-DTD toewijzen. Als uw document geen DOCTYPE bevat, of het doctype is onbekend, kies dan een meta-DTD op uw harde schijf. Anders zal het meta-DTD dat overeenkomt met het DOCTYPE van het document automatisch worden geladen.

U kunt nu de plugin gebruiken terwijl u tekst intypt:

< (toets minder dan)

  Dit zal een lijst openen met mogelijke elementen, tenzij de cursor zich al in een tag bevindt. Opmerking: u kunt dit niet gebruiken als u een hoofdelement wilt invoegen (zoals <html>).

" (toets dubbele aanhaling)

  De toets dubbele aanhaling zal een lijst met mogelijke attribuutwaarden openen (indien aanwezig) als de cursor in een tag staat.

(spatietoets)

  Deze toets zal een lijst openen met mogelijke attributen voor het huidige element als de cursor in een tag staat.

& (toets ampersand)

  Deze toets zal een lijst met named-entiteiten openen.

## Functies en beperkingen

U kunt alle functies en beperkingen testen door het bestand `$KDEDIR/share/apps/katexmltools/testcases.xml` in &kate; te laden en de instructies te volgen. Opmerking: het werken met meerdere weergaven per document wordt momenteel niet goed onderstund door deze plugin.

## Menustructuur

XML Element invoegen...

  Dit opent een dialoog waarmee u een XML-element kunt invoegen. De tekens <,> en de afsluitende tag zullen automatisch worden ingevoegd. Als u deze menuoptie kiest terwijl er tekst is geselecteerd, dan zal de geselecteerde tekst worden omgeven door de openings- en afsluitende tags. De dialoog biedt ook auto-aanvulling voor alle elementen die ingevoegd mogen worden op de huidige cursorpositie volgens de meta-DTD die u hebt toegewezen via menuoptie Meta-DTD toewijzen....

XML Element sluiten

  Deze optie zoekt naar een tag die nog niet is gesloten, en zal deze sluiten door de bijhorende afsluitende tag in te voegen. De zoekactie begint bij de cursorpositie en gaat naar links. Als er geen openstaande tag wordt gevonden gebeurt er niets.

XML Meta-DTD toewijzen...

  Hiermee kunt u het meta-DTD bepalen voor het huidige document. Opmerking: deze toewijzing zal niet worden opgeslagen. U dient telkens als u &kate; start het meta-DTD opnieuw toewijzen.

## Dankbetuigingen en licentie

&kate;-plugin XML Completion copyright 2001,2002 Daniel Naber daniel.naber@t-online.de.

Documentatie copyright 2001,2002 Daniel Naber

&meld.fouten;&vertaling.niels; &underGPL;