# &XML;-aanvulling

Daniel
Naber

    &Daniel.Naber.mail;

2006-05-17
3.5.2

Deze plugin ondersteunt het schrijven van &XML;-bestanden door het aanbieden van een lijst met toegestane 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, attribuutwaarden 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 dichtstbijzijnde geopende tag links van de cursor te sluiten.

DE DTD dient aanwezig 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, moet u het programma `dtdparse` van http://dtdparse.sourceforge.net installeren.

## Hoe te gebruiken

Start &kate; en kies het menu-item Instellingen &kate; instellen.... In het dialoogvenster dat wordt geopend kiest u vervolgens de sectie Toepassing Plugins. Selecteer in deze sectie Kate XML-aanvulling en bevestig uw keuze. Kies dan in het hoofdvenster van &kate; het menu-item XML Meta-DTD toewijzen. Als uw document geen DOCTYPE bevat, of het doctype is onbekend, kies dan een meta-DTD op uw harde schijf. In andere gevallen 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:

< (kleiner dan-toets)

  Opent een lijst met mogelijke elementen, tenzij de cursor zich al in een tag bevindt. Opmerking: u kunt dit niet gebruiken als u een hoofdelement wilt invoegen (&eg; <html>).

" (dubbel aanhalingsteken-toets)

  Opent een lijst met mogelijke attribuutwaarden (indien aanwezig) als de cursor zich in een tag bevindt.

(spatiebalk)

  Opent een lijst met mogelijke attributen voor het huidige element als de cursor zich in een tag bevindt.

& (ampersand-toets)

  Opent een lijst met benoemde entiteiten.

## 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 ondersteund door deze plugin.

## Menustructuur

&Ctrl;Enter XML Element invoegen...

  Opent een dialoogvenster waarin 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, zal de geselecteerde tekst worden omgeven door de openings- en afsluitende tags. Het dialoogvenster 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....

&Ctrl;< 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 moet telkens als u &kate; start het meta-DTD opnieuw toewijzen.

## Dankbetuigingen en licentie

&kate;-plugin XML Completion copyright 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;

Documentatie copyright 2001,2002 &Daniel.Naber;

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