Kate-plugin-håndbogen
Ophavsret © 2001, 2002
Tilladelse er hermed givet til at kopiere, videregive og/eller ændre dette dokument under betingelserne i GNU's Fri Dokumentation License, Version 1.1 eller en vilkårlig senere version publiceret af Free Software Foundation; uden invariante afsnit, uden tekster før omslaget, og uden tekster efter omslaget. En kopi af licensen er inkluderet i afsnittet ved navn " Medvirkende og licens".
Dette er håndbogen for plugin for Kate, KDE's avancerede teksteditor.
Indholdsfortegnelse
Kate's plugin er yderligere funktioner for editoren Kate. De kan tilføje ekstra menuer og genvejstaster, og udvide Kates funktioner. Du kan installere så mange eller så få som du vil, inde i Kate. Åbn Kates indstillingsdialog med ->. Vælg -> for at vælge de ønskede plugin.
Flere oplysninger om brug af Kate og aktivering af de plugin du ønsker findes i Kate-håndbogen.
De plugin der er installeret i denne håndbog er:
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 (f.eks. 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 . For at producere dine egne meta-DTD'er, skal du have dtdparse fra http://dtdparse.sourceforge.net.
Start Kate og åbn indstillingsdialogen med ->. Markér derefter Kate XML-komplettering, som vises i afsnittet Program Plugin. Vælg derefter ->. 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:
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>”).
Citationstasten vil udløse en liste af mulige attributværdier (hvis der er nogen) hvis du er indeni et mærke.
Denne tast vil udløse en liste af mulige attributter for det aktuelle element hvis du er indeni et mærke.
Denne tast vil udløse en liste af navngivne entiteter.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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 .
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.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-plugin “XML-Komplettering” ophavsret 2001,2002 ved Daniel Naber (daniel.naber AT t-online.de).
Dokumentation ophavsret 2001,2002 Daniel Naber
Dansk oversættelse Erik Kjær Pedersen (erik AT binghamton.edu)
Dette program er udgivet under betingelserne i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dette plugin undersøger den aktuelle fil. En liste over advarsler og fejl vil fremkomme i bunden af Kates hovedvindue. Du kan klikke på en fejlmeddelelse for at hoppe til det tilsvarende sted i filen. Hvis filen har en “DOCTYPE”, vil den til denne doctype givne DTD blive brugt til at undersøge filens gyldighed. DTD'en forventes at være placeret relativt til den aktuelle fil. Hvis f.eks. doctypen henviser til “DTD/xhtml1-transitional.dtd” og filen er /home/peter/test.xml, så forventes DTD'en at være /home/peter/DTD/xhtml1-transitional.dtd. Eksterne DTD'er specificeret via http er imidlertid understøttet.
Hvis filen ikke har nogen doctype, vil den blive undersøgt for veludformning.
For at lære mere om XML, se de officielle W3C XML-sider.
Internt kalder dette plugin den eksterne kommando xmllint som er en del af libxml2. Hvis denne kommando ikke er korrekt installeret på dit system, vil dette plugin ikke fungere.
Det er nødvendigt at skrive en midlertidig fil til den mappe som indeholder filen der skal undersøges, så du er nødt til at have skriveadgang til den mappe.
For at indlæse dette plugin, åbnes først Kates indstillingsdialog under -> . Markér derefter Kate XML-validering, som vises under Program Plugin og luk dialogen.
Kate-plugin “XML-validering” - ophavsret 2002 Daniel Naber (daniel.naber AT t-online.de).
Dokumentation - ophavsret 2002 Daniel Naber
Dansk oversættelse Lars Schunk (lars AT schunk.dk)
Dette program er udgivet under betingelserne i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
“Indsæt kommando”-plugin tillader dig at indsætte uddata fra skalkommandoer i et dokument der er åbent i Kate.
Aktivér først pluginnet “Indsæt kommando” ved at bruge dialogen -> og markér Kate Indsæt kommando i Program i fanebladet Plugin og luk dialogen.
For at bruge dette plugin vælges fra -menuen. Den vil præsentere dig for en lille dialog til indtastning af kommandoen, valg af arbejdsmappe og valg af om du vil have (STDERR uddata) inkluderet i den indsatte tekst. Du kan også få kommandostrengen skrevet oven over uddata.
Dette plugin kan huske et antal kommandoer som valgt på indstillingssiden. Disse bruges til auto-komplettering og kan vælges fra en liste i kommando-indgangen.
Som standard vil kommando køre i arbejdsmappen for kate-processen, hvilket sædvanligvis er din hjemmemappe. Dette kan ændres i indstillingssiden for dette plugin.
Bemærk at en vilkårlig skal-kommando der kræver inddata fra brugeren (for eksempel kodeord) eller bruger en ncurses-grænseflade eller noget lignende (for eksempel top) ikke vil kunne producere de forventede uddata.
For at indstille pluginnet “Indsæt kommando”, åbnes Kates indstillingsdialog i menuen -> og så vælges +Indsæt kommando.
Følgende indstillingsmuligheder er til stede:
Denne indstilling præsenteres som et spinfelt, som du kan sætte til antallet af kommandoer der skal huskes. Et vilkårligt antal fra 0 til 99 er lovligt. Standard er 20.
Denne indstilling, præsenteret som et sæt radioknapper, tillader dig at afgøre hvordan arbejdsmappen for en kommando vælges. Valgmulighederne er arbejdsmappen for Kate-processen (sædvanligvis din hjemmemappe hvis Kate er startet fra K-menuen), mappen for dokumentet (hvis der er en, ellers bruges ovennævnte mulighed) eller arbejdsmappen for den sidste kommando kørt i dette plugin.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-plugin “Indsæt kommando” ophavsret 2001 ved Anders Lund (anders AT alweb.dk).
Dokumentation ophavsret 2001 Anders Lund (anders AT alweb.dk)
Dansk oversættelse Erik Kjær Pedersen (erik AT binghamton.edu)
Dette program er udgivet under betingelserne i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dette plugin viser en dialog som spørger efter et HTML-mærkenavn. Egenskaber og værdier som skal tilføjes i den indledende mærke skal skrives ind som egenskabsnavn="egenskabsværdi"
Kate-pluginnet “HTML-værktøj” ophavsret 2002 Joseph Wenninger (kde AT jowenn.at).
Dokumentation opgavsret 2005 Francis Giannaros
Dansk oversættelse Erik Kjær Pedersen (erik AT binghamton.edu)
Dette program er udgivet under betingelserne i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-plugin “Open Header” har ingen dokumentation for øjeblikket. Hvis du er interesseret i rette op på denne situation, så kontakt venligst Lauri Watts (lauri AT kde.org), KDE's dokumentationsholds koordinator.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-plugin “Tekstfilter” har ingen dokumentation for øjeblikket. Hvis du er interesseret i rette op på denne situation, så kontakt venligst Lauri Watts (lauri AT kde.org), KDE's dokumentationsholds koordinator.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Filskabelon-plugin tillader dig at lave filer baseret på andre filer. Du kan bruge en vilkårlig fil som skabelon, hvilket vil lave en kopi af filen med en tom URL, eller bruge en speciel skabelonfil som kan indeholder makroer til at udfylde information s[som dit navn og e-mail-adresse, dagens dato og så videre, og placere markøren et godt sted i den nye fil.
Derudover vil skabeloner der er i skabelonmapper blive præsenteret under menupunktet ->.
Dette plugin sørger også for en metode til nemt at lave en ny skabelon ud fra et åbent dokument.
Skabelonmapper en en del af KDE's filsystem, og består af i det mindste KDEDIR/share/applications/kate/plugins/katefiletemplates/templates og KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Hvis din KDEDIRS miljøvariabel indeholder yderligere mapper, gennemsøges disse også for en lignende undermappe. Hvis skabeloner med samme navn bliver fundet, så vælges den i den lokale (KDEHOME)-mappe.
Præsentere dig for en 'Åbn fil'-dialog der lader dig bruge en vilkårlig fil som skabelon. Hvis den valgte fil har endelsen katetemplate vil den blive fortolket for skabeloninformation og makroer.
Præsentere en liste af filer der er blevet brugt som skabeloner for nylig, repræsenteret ved deres URL.
De tilbageværende undermenuer indeholder link til skabeloner. Klik på et menupunkt for at lave en fil som beskrevet i menupunktets tekst.
Dette vil starte en dialog med en liste af alle skabeloner fundet indeni skabelonmapperne, sammen med valgmuligheder for at tilføje, redigere eller fjerne skabeloner.
Når der laves en fil ud fra en skabelon der indeholder makroer, vil nogle makroer ses som redigerbare variabler i teksten. Sådanne variabler ses som understregede ord i teksten.
Den første variabel vil blive valgt, så skal blot skrive for at redigere den. Hvis dokumentets tekst indeholder flere dugaver af den samme variabel, bliver de også ændret mens du redigerer. For at gå til den næste redigerbare variabel, så tryk på TAB-tasten. Når den sidste variabel er redigeret, droppes listen og din TAB-tast virker igen som normalt.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
For at lave en ny skabelon, bruges punktet -> til at starte skabelonhåndteringsdialogen. I den klikkes på for at startet Filskabelon-guiden. Du vil blive spurgt om der er en fil du vil lave om til en skabelon og bedt om skabeloninformationsindstillinger, og en skabelonfil vil blive lavet for dig.
Alternativt kan du lave en skabelon manuelt ved at tilføje skabeloninformation foroven i en vilkårlig fil, tilføje tekst og makroer og og gemme den med endelsen katetemplate.
Skabelonmenuen blive automatisk opdateret hvis du valgte at gemme din skabelon i skabelonmappen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
For at redigere en skabelon bruges ->. Vælg skabelonen du ønsker at arbejde med og klik på , så vil skabelonfilen blive åbnet. Luk dialogen, redigér skabelonfilen som ønsket, gem den og luk den. Ændringer af skabelonerne får øjeblikkelig virkning, du kan aktivere skabelonen for at teste dine ændringer efter du har gemt den.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Hvis du bruger filer med endelsen katetemplate, vil de blive fortolket for skabeloninformation, makroer og markørposition.
Mens filen læses holder tolkeren linjer der begynder med udtrykket katetemplate: og gennemsøger dem for skabeloninformation på formen VARIABLENAME=VALUE. Den første linje der ikke starter med katetemplate: vil blive opfattet som skabelonens indhold. VALUE kan indeholde et vilkårligt tegn bortset fra lighedstegnet (=). Lovlige variabelnavne er:
SkabelonDette er skabelonnavnet, vist i menuen ->.
GruppeGruppen placerer skabelone i en undermenu for menuen ->.
NavnDette er navnet der vil blive sat for dokumentet, og vist i fillisten og titellinjen. Hvis navnet indeholder %N vil det blive erstattet med et tal, der øges hvis flere dokumenter har samme navn.
FremhævDette plugin vil forsøge at sætte fremhævning for det nye dokument til værdien for denne variabel. Værdien skal være navnet, som fundet i ->.
BeskrivelseEn kort informativ beskrivelse af skabelonen. Dette bruges for øjeblikket til at sætte en 'Have er dette'-streng for menupunktet, men kan bruges til flere formål i fremtiden.
En streng der identificerer forfatteren, for eksempel på formen Navn <e-mail-adresse>. Dette bruges for øjeblikket til at sætte en 'Have er dette'-streng for menupunktet, men kan bruges til flere formål i fremtiden..
Når skabelonens indhold fortolkes, bliver makroer på formen %{NAME} eller ${NAME} udvidet. Hvis du bruger $-præfikset, vil de udvidede makroer blive behandlet som en redigerbar variabel når et dokument oprettes ud fra skabelonen, hvorimod hvis du bruger % sker dette ikke, medmindre udvidelsen er mislykket.
Følgende makroer udvides:
Udvides til det nuværende tidspunkt på dit lokale format.
Udvides til nuværende dato på kort format.
Udvider til dato og tidspunkt, formateret som en streng ifølge dine lokale indstillinger.
Det nuværende år som et fircifret tal.
Det fulde navn på måneden, ifølge de lokale indstillinger.
Udvides til månedens nuværende dag.
Udvides til 'hostname' for din computer.
Udvides til 'i'.
Udvides til dit fulde navn, som defineret i din ejeradresse i KDE's standard-adressebog.
Udvides til dit fornavn, som defineret i din ejeradresse i KDE's standard-adressebog.
Udvides til dit efternavn, som defineret i din ejeradresse i KDE's standard-adressebog.
Udvides til din e-mail-navn, som defineret i din ejeradresse i KDE's standard-adressebog.
Enhver makro der ikke er i ovenstående liste behandles som en redigerbar variabel uanset præfiks. Hvis den samme variabel forekommer flere gange i skabelonen, kan de redigeres på en gang efter et dokument er oprettet ud fra skabelonen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-plugin “Fil-skabeloner” ophavsret 2004 Anders Lund (anders AT alweb.dk).
Dokumentation ophavsret 2004 Anders Lund
Dansk oversættelse Erik Kjær Pedersen (erik AT binghamton.edu)
Dette program er udgivet under betingelserne i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ophavsret for hvert panelprogram er angivet i det dertil svarende kapitel.
Dokumentation er udgivet under betingelserne i GNU Free Documentation License.
Dette program er udgivet under betingelserne i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team