# &XML;-komplettering

## Indledning

Dette plugin giver vink om hvad der er tilladt på et bestemt sted i en &XML;-fil, ifølge filens DTD. Det vil give en liste af mulige elementer, attributter, attribut-værdier eller entiteter, afhængig af markørens aktuelle position (⪚ er alle entiteter på en liste hvis tegnet til venstre for markøren er &). Det er også muligt at lukke det nærmeste åbne mærke til venstre.

DTD'en skal findes i &XML;-format, som produceret af Perl-programmet `dtdparse`. Vi vil kalde en DTD i dette en meta-DTD. Nogle meta-DTD'er medfølger. De er installerede i `$TDEDIR/share/apps/katexmltools/`, som også er standardmappen når du vælger Tilknyt Meta-DTD.... For at producere dine egne meta-DTD'er, skal du have `dtdparse` fra http://dtdparse.sourceforge.net.

## Hvordan bruges det

Start &kate; og åbn indstillingsdialogen med Opsætning Indstil &kate;.... Markér derefter Kate XML-komplettering, som vises i afsnittet Program Plugin. Vælg derefter XML Tilknyt meta-DTD.... Hvis dokumentet ikke indeholder en doctype eller en ukendt doctype, skal du vælge en meta-DTD i filsystemet. Ellers så indlæses den meta-DTD som hører sammen med det nuværende dokuments doctype automatisk.

Du kan nu bruge dette plugin mens du skriver din tekst:

< (mindre end-tasten)

- Dette vil udløse en liste af mulige elementer, med mindre markøren allerede er indeni et mærke. Bemærk at du ikke for øjeblikket kan bruge dette til at indsætte topniveau-elementet (f.eks. <html>).

" (citationstegn-tast)

- Citationstasten vil udløse en liste af mulige attributværdier (hvis der er nogen) hvis du er indeni et mærke.

(mellemrumstast)

- Denne tast vil udløse en liste af mulige attributter for det aktuelle element hvis du er indeni et mærke.

& (ét-tasten)

- Denne tast vil udløse en liste af navngivne entiteter.

## Egenskaber og begrænsninger

Du kan teste alle funktioner og begrænsninger ved at indlæse `$TDEDIR/share/apps/katexmltools/testcases.xml` i &kate; og følge instruktionerne. Bemærk at arbejde med mere end en visning pr dokument endnu ikke er understøttet rigtigt af dette plugin.

## Menustruktur

&Ctrl;Retur XML Indsæt element...

- Dette vil åbne en dialog der lader indsætte et &XML;-element. <-, >-tegnene og afslutningsmærket vil blive indsat automatisk. Hvis du har markeret tekst når dette menupunkt er valgt, vil den markerede tekst blive omgivet af åbnings- og afslutningsmærket. Dialogen tilbyder også komplettering af alle elementer der kan indsættes ved den aktuelle markørposition hvis du har tilknyttet en meta-DTD ved brug af Tilknyt Meta-DTD....

&Ctrl;< XML Afslut element

- Dette vil gennemsøge din tekst for et mærke, der endnu ikke er lukket og vil lukke det ved at indsætte det tilsvarende lukke-mærke. Søgningen starter ved markørens position og går til venstre. Hvis den ikke kan finde et åbent mærke så vil ingenting ske.

XML Tilknyt meta-DTD...

- Dette vil fortælle dette plugin hvilket meta-DTD der skal bruges for det aktuelle dokumenter. Bemærk at denne tilknytning ikke vil blive gemt. Du vil skulle gentage det når du starter &kate; næste gang.

## Tak og anerkendelser

&kate;-plugin XML-Komplettering ophavsret 2001,2002 ved &Daniel.Naber; &Daniel.Naber.mail;.

Dokumentation ophavsret 2001,2002 &Daniel.Naber;

&erik.kjaer.pedersen.credit; &underGPL;