# XML-aanvulling

## Inleiding

Deze plugin geeft tips over wat toegestaan is op een bepaalde positie in een XML-bestand, volgens het DTD van het bestand. Het geeft een lijst met mogelijke elementen, attributen, attribuutwaarden of entiteiten, afhankelijk van de cursorpositie (⪚ alle intiteiten worden opgesomd als het karakter aan de linkerzijde van de cursor & is). Het is ook mogelijk om de dichstbijzijnde geopende tag links van de cursor te sluiten.

De DTD dient te bestaan in XML-formaat, zoals geproduceerd wordt door het Perl-programma `dtdparse`. We zullen een DTD in dit formaat meta-DTD noemen. Enkele meta-DTD's worden reeds aangeleverd. Ze zijn geïnstalleerd in `$KDEDIR/share/apps/katexmltools/`. Dit is ook de standaardmap als u Meta-DTD toewijzen... selecteert. Om uw eigen meta-DTD's te kunnen produceren, download `dtdparse` van http://dtdparse.sourceforge.net.

## Hoe te gebruiken

Start Kate en selecteer Kate XML-aanvulling in de sectie Applicatie/Plugins. van Kate's configuratiedialoogvenster. U kunt het dialoogvenster openen via Instellingen Kate instellen.... Selecteer hierna XML-plugin Meta-DTD toewijzen. Als uw document geen DOCTYPE bevat, of de doctype onbekend is, selecteer dan een meta-DTD van uw harde schijf. Anders zal de meta-DTD die overeenkomt met de huidige DOCTYPE van het document automatisch worden geladen.

U kunt nu de plugin gebruiken terwijl u uw tekst intypt:

< (minder dan-toets)

- Deze toets zal een lijst met mogelijke elementen openen, tenzij de cursor zich reeds binnen een tag bevindt. Opmerking: u kunt dit momenteel niet gebruiken om een topniveau-element in te voeren (bijv. <html>).

" (aanhalingstoets)

- De aanhalingstoets zal een lijst met mogelijke attribuutwaarden openen (als die er zijn) als u zich binnen een tag bevindt.

(spatietoets)

- Deze toets zal een lijst met mogelijke attributen voor het huidige element openen als u zich binnen een tag bevindt.

& (ampersandtoets)

- Deze toets zal een lijst met benoemde entiteiten openen.

## Functies en beperkingen

U kunt alle mogelijkheden en beperkingen testen door `$KDEDIR/share/apps/katexmltools/testcases.xml` in &kate; te laden en de instructies op te volgen. Opmerking: het werken met meer dan een weergave per document wordt momenteel niet correct ondersteund door deze plugin.

## Menustructuur

XML-plugin Element invoegen...

- Dit zal een dialoogvenster openen waarmee u een XML-element kunt invoegen. De karakters <,> en de afsluitende tag zullen automatisch worden ingevoegd. Als u tekst hebt geselecteerd voordat u dit menu-item selecteerde, dan zal deze tekst worden omgeven door de openingstag en afsluitende tag. Als u een meta-DTD hebt toegewezen via Assign Meta DTD... dan biedt het dialoogvenster ook het aanvullen van alle elementen die kunnen worden ingevoegd op de huidige cursorpositie

XML-plugin Element sluiten

- Dit zal uw tekst doorzoeken op tags die nog niet zijn afgesloten en zal deze afsluiten door de bijhorende afsluitende tag in te voegen. De zoekactie begint bij de cursorpositie en gaat naar links. Als er geen openingstag gevonden wordt gebeurt er verder niets.

XML-plugin Meta-DTD toewijzen...

- Dit zal de plugin vertellen welk meta-DTD zal worden gebruikt voor het huidige document. Opmerking: deze toewijzing zal niet worden opgeslagen. U dient ze dus te herhalen als u &kate; de volgende keer opstart.

## Bedankingen en erkenningen

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

Documentatie: copyright 2001,2002 Daniel Naber

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