# 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 `$KDEDIR/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 vælg Kate XML-komplettering som vil være i Program/Plugin-afsnittet under Opsætning Indstil Kate... Derefter vælges XML-Indstil Tilknyt Meta-DTD. Hvis dit dokument ingen DOCTYPE indeholder doctype er ukendt, vil du skulle vælge en meta-DTD fra filsystemet. Ellers vil den meta-DTD der matcher det aktuelle dokuments DOCTYPE blive indlæst 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 `$KDEDIR/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

XML-plugin 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....

XML-plugin Luk 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-plugin 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@t-online.de.

Dokumentation ophavsret 2001,2002 Daniel Naber

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