# &XML;-komplettering

Daniel
Naber

    &Daniel.Naber.mail;

2006-05-17
3.5.2

Dette plugin understøtter at skrive &XML;-filer ved at give en liste af tilladte mærker og mere.

KDE
kate
xml

# 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 (&eg; 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 å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 `$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

&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;