&Anders.Lund; &Anders.Lund.mail; &Dominik.Haumann; &Dominik.Haumann.mail; &erik.kjaer.pedersen.role; Kommentér og afkommentér-kommandoerne, der er tilgængelige fra Værktøjsmenuen tillader dig at tilføje eller fjerne kommentarmarkeringer til det udvalgte, eller den aktuelle linje hvis ingen tekst er markeret, hvis kommentarer er understøttet af det tekstformat du redigerer. Reglerne for hvordan kommentering gøres er defineret i syntaksdefinitionerne, så hvis syntaksfremhævning ikke bruges, vil kommentering/afkommentering ikke være mulig. Nogle formater definerer enkeltlinje kommenteringsmarkeringer, nogle multilinjemarkeringer og nogle begge. Hvis multilinjemarkeringer ikke er tilgængelige, vil kommentering af en markering der ikke fuldt indeholder dens sidste linje ikke være mulig. Hvis enkeltlinjemarkeringer er tilgængelige, er kommentering af enkelte linjer foretrukket hvor det kan anvendes, da det hjælper med at undgå problemer med kommentarer der ligger inden i hinanden. Når kommentarmarkeringer fjernes, bør ingen ukommenteret tekst være valgt. Når multilinje kommentarmarkeringer fjernes fra et udvalg, bliver alt hvidt udenfor kommentarmarkeringerne ignoreret. kommentér For at placere kommentarmarkeringer bruges VærktøjKommentér-menupunktet elle den tilsvarende tastaturgenvej, der som standard er &Ctrl;D. afkommentér For at fjerne kommentarmarkeringer bruges VærktøjerAfkommentér-menupunktet eller den tilsvarende tastaturgenvej, der som standard er &Ctrl;&Shift;D. Kate's editorkomponent har en intern kommandolinje, som lader dig udføre visse handlinger fra en minimal grafisk grænseflade. Kommandolinjen er et tekstindtastningsfelt længst nede i redigeringsområdet. For at vise det, vælges Vis Skift til kommandolinje eller genvejstasten (normalt F7) bruges. Editoren sørger for et sæt kommandoer som er dokumenterede nedenfor, og yderligere kommandoer kan varetages af plugin. For at udføre en kommando, skrives kommandoen og så trykkes på returtasten. Kommandolinjen angiver om kommandoen lykkedes og viser måske en meddelelse. Hvis du kom til kommandolinjen ved at trykke på F7 skjules den automatisk efter nogle sekunder. For at rydde meddelelsen og indtaste en ny kommando, trykkes på F7 igen. Kommandolinjen har et indbygget hjælpesystem, udsted kommandoen help for at komme i gang. For at se en liste med alle tilgængelige kommandoer, skrives help list. For at vise hjælp om en bestemt kommando, skrives help kommando. Kommandolinjen har en indbygget historik, så du kan genbruge kommandoer som allerede er skrevet ind. For at navigere i historikken, bruges tasterne Pil opad og Pil nedad. Når historikkommandoer vises er kommandoernes argument markerede, hvilket lader dig nemt overskrive argumenterne. Disse kommandoer sørges for af editorkomponenten og lader dig kun indstille det aktive dokument og visningen. Dette er praktisk hvis du vil bruge en indstilling som adskiller sig fra standardindstillingen, for eksempel for indrykning. BOOLESK Denne bruges med kommandoer som slår noget til eller fra. Mulige værdier er on (til), off (fra), true (sand), false (falsk), 1 eller 0. HELTAL Et heltal STRENG En streng set-tab-widthHELTAL bredde Indstiller tabulatorbredden til tallet bredde set-indent-widthHELTAL bredde Indstiller indrykningsbredden til tallet bredde. Bruges kun hvis du indrykker med mellemrum. set-word-wrap-columnHELTAL bredde Indstiller linjebredden for hårdt linjebrud til bredde. Dette bruges hvis du bruger automatisk linjebrud for din tekst. set-icon-borderBOOLESK Indstiller synligheden af ikonkanten. set-folding-markersBOOLESK aktivér Indstiller synligheden af foldningsmarkørruden. set-line-numbersBOOLESK aktivér Indstiller synligheden af linjenummerruden. set-replace-tabsBOOLESK aktivér Hvis aktiveret, erstattes tabulatortegn med mellemrum mens du skriver. set-remove-trailing-spaceBOOLESK aktivér Hvis aktiveret, fjernes afsluttende blanke tegn så snart markøren forlader en linje. set-show-tabsBOOLESK aktivér Hvis aktiveret, synliggøres tabulatortegn og afsluttende blanke tegn med en lille prik. set-indent-spacesBOOLESK aktivér Hvis aktiveret, indrykker editoren med indrykningsbredde mellemrum for hvert indrykningsniveau, i stedet for et tabulatortegn. set-mixed-indentBOOLESK aktivér Hvis aktiveret, bruger Kate en blanding af tabulatortegn og mellemrum for indrykning. Hvert indrykningsniveau har bredden indrykningsbredde, og flere indrykningsniveauer optimeres så at så mange tabulatortegn som muligt bruges. Når det udføres aktiverer kommandoen desuden indrykning med mellemrum, og hvis indrykningsbredden ikke angives indstilles den til halvdelen tabulatorbredden for dokumentet. set-word-wrapBOOLESK aktivér Aktiverer dynamisk linjebrud ifølge aktivér set-replace-tabs-saveBOOLESK aktivér Hvis aktiveret, erstattes tabulatortegn med blanke tegn så snart dokumentet gemmes. set-remove-trailing-space-saveBOOLESK aktivér Hvis aktiveret, fjernes afsluttende mellemrum fra alle linjer så snart dokumentet gemmes. set-indent-modenavn Indstiller automatisk indrykningstilstand til navn. Hvis navn ikke genkendes, indstilles tilstanden til 'none'. Gyldige tilstande er 'cstyle', 'csands', 'xml', 'python', 'varindent' og 'none'. set-highlightfremhævning Indstiller dokumentets syntaksfremhævningssystem. Argumentet skal være et gyldigt fremhævningsnavn, som vises i menuen Værktøjer Fremhævning. Kommandoen sørger for en liste for automatisk komplettering af argumentet. Disse kommandoer ændrer nuværende dokument. indent Indrykker de markerede linjer eller den nuværende linje. unindent Afindrykker markerede linjer eller nuværende linje. cleanindent Rydder indrykningen for markerede linjer eller nuværende linje ifølge dokumentets indrykningsindstillinger. comment Indsætter kommentarmarkeringer for at give markeringen, markerede linjer eller nuværende linje en kommentar ifølge tekstformatet som defineres af dokumentets syntaksfremhævningsdefinition. uncomment Fjerner kommentarmarkeringer fra markeringen, markerede linjer eller nuværende linje ifølge tekstformatet som defineres af dokumentets syntaksfremhævningsdefinition. kill-line Sletter den nuværende linje. replacemønstererstatning Erstatter tekst som matcher mønster med erstatning. Hvis du ønsker at mønster skal indeholde blanke tegn, skal både mønster og erstatning placeres indenfor enkelte eller dobbelte citationstegn. Hvis argumenterne ikke er citerede, bruges det første ord som mønster og resten som erstatning. Hvis erstatning er tom, fjernes hver forekomst af mønster. Du kan indstille kommandoen ved at tilføje et kolon fulgt af et eller flere bogstaver som hvert repræsenterer en indstilling, ved at angive replace:tilvalg mønster erstatning. Tilgængelige tilvalg er: b Søg baglæns. c Søg fra markørens position. e Søg kun i markeringen. r Udfør en søgning med et regulært udtryk. Hvis det angives, kan du bruge \N, hvor N er et tal, til at repræsentere fundet tekst i erstatningsstrengen. s Udfør versalfølsom søgning. p Spørg efter tilladelse til at erstatte næste forekomst. w Match kun hele ord. dateformat Indsætter en dato- og tidsstreng som defineres af angivet format, eller formatet yyyy-MM-dd hh:mm:ss hvis intet angives. Følgende oversættelser udføres når format tolkes: dDagen som et tal uden indledende nul (1-31). ddDagen som et tal med indledende nul (01-31). dddDagens forkortede lokale navn (f.eks. 'man', 'søn'). ddddDagens lange lokale navn (f.eks. 'mandag', 'søndag'). MMåneden som et tal uden indledende nul (1-12). MMMåneden som et tal med indledende nul (01-12). MMMMånedens forkortede lokale navn (f.eks. 'jan', 'dec'). yyÅret som et tal med to cifre (00-99) yyyyÅret som et tal med fire cifre (1752-8000) hTimen uden indledende nul (0-23 eller 1-12 hvis AM/PM vises). hhTimen med indledende nul (00-23 eller 01-12 hvis AM/PM vises). mMinut uden indledende nul (0-59). mmMinut med indledende nul (00-59). sSekund uden indledende nul (0-59). ssSekund med indledende nul (00-59). zMillisekunder uden indledende nul (0-999). zzzMillisekunder med indledende nul (000-999). APBrug AM/PM visning. AP erstattes enten af "AM" eller "PM". apBrug am/pm visning. ap erstattes enten af "am" eller "pm". charidentifier Denne kommando tillader dig at indsætte tegn efter deres numeriske identifikator, i decimal, oktal eller hexadecimal form. For at bruge den starter du Redigeringskommando-dialogen og skriver char: [number] i indgangsfelterne, og trykker så på O.k.. Inddata: char:234 Udskrift: ê Inddata: char:0x1234 Udskrift: ሴ erstat, sed-stil søg, sed-stil s///[ig] %s///[ig] Denne kommando udfører en sed-lignende søg/erstat-operation på den aktuelle linje, eller på hele filen (%s///). Kort fortalt gennemsøges teksten for tekst der matcher søge-mønstret, det regulære udtryk mellem den første og anden skråstreg, og når en match findes, så erstattes den matchende del af teksten med det udtryk der er mellem den midterste og sidste del af strengen. Parenteser i søgemønstret laver tilbage-referencer,hvilket betyder at kommandoen huskler hvilken den af matchen der matchede i parenteser; disse strengs kan genbruges i erstatningsmønstret, refereret til som \1 for det første sæt parenteser, \2 for det andet og så videre. For at søge efter en rigtig ( ( eller ), må du escape den ved brug af et tegnet: \(\) Hvis du tilføjer i til sidst i udtrykket, bliver matchningen versalufølsom. Hvis du tilføjer g til sidst, erstattes alle forekomster af mønstret, ellers erstattes kun den første forekomst. Din meget venlige compiler stoppede netop, og fortale dig at klassen minKlasse nævnt i linje 3902 i din kildefil ikke er defineret. "Pokkers!" tænker du, det er selvfølgelig MinKlasse. Du går til linje 3902, og i stedet for at prøve at finde ordet i teksten, starter du Redigeringskommando-dialogen, indtaster s/minKlasse/MinKlasse/i, trykker på O.k.-knappen, gemmer filen og kompilerer – med held, uden fejl. Forestil dig at du har en fil, i hvilken du nævner en Frøken Pedersen adskillige gange, og så kommer der nogen ind og fortæller dig at hun lige er blevet gift med Hr Krogh. Du vil nu selvfølgelig erstatte hver forekomst af Frøken Pedersen med Fru Krogh. Start kommandolinjen, og skriv kommandoen: %s/Frøken Jensen/Fru Jensen/, tryk på returtasten og du er færdig. Dette eksempel gør brug af tilbagereferencer såvelsom tegnklasse (hvis du ikke ved hvad det er, så referér til den relaterede dokumentation nævnt nedenfor). Antag du har følgende linje: void MyClass::DoStringOps( String &foo, String &bar String *p, int &a, int &b ) Du bliver nu klar over at det ikke er pæn kodning, og beslutter dig for at du ønsker at bruge const nøgleordet for alle adresser på argumenter, dem der er karakteriseret ved &-operatoren foran argumentnavnet. Du vil også gerne forenkle mellemrum, så der kun er 1 mellemrumstegn mellem hvert ord. Start Redigeringskommando-dialogen og indtast: s/\s+(\w+)\s+(&)/ const \1 \2/g og tryk på O.k.-knappen. g'et i slutningen af udtrykket får det regulære udtryk til at omkompilere for hver match og gemme til backreferences. Uddata: void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b ) Operationen overstået! Hvad skete der egentlig? Vi kiggede efter mellemrum (\s+) fulgt af et eller flere alfabetiske tegn (\w+) fulgt af nogle flere mellemrum (\s+) fulgt af et ét-tegn, og under processen gemtes den alfabetiske stump og ét-tegnet til genbrug i erstatningsoperationen. Vi erstattede så den matchende del af vores linje med et enkelt mellemrum fulgt af const fulgt af et mellemrum fulgt af vores gemte alfabetiske stump (\1) fulgt af et mellemrum fulgt af vores gemte ét-tegn (\2) I visse tilfælde var vores alfabetiske stump Streng, i andre tilfælde int, så ved brug af karakterklassen \w og +-quantifier viste sig at være meget nyttig. gotoHELTAL linje Denne kommandoen går til den angivne linje. findmønster Kommandoen går til første forekomst af mønster ifølge indstillingen. Følgende forekomster kan findes ved at bruge Redigér Søg igen (normal genvejstast er F3). Kommandoen kan indstilles ved at tilføje et kolon fulgt af et eller flere tilvalg. Formatet er find:tilvalg mønster. Følgende tilvalg understøttes: b Søg baglæns. c Søg fra markørens position. e Søg kun i markeringen. r Udfør en søgning med et regulært udtryk. Hvis det angives, kan du bruge \N, hvor N er et tal, til at repræsentere fundet tekst i erstatningsstrengen. s Udfør versalfølsom søgning. w Match kun hele ord. ifindmønster Kommandoen sørger for søgning mens du skriver. Du kan indstille opførslen eller søgningen ved at tilføje et kolon fulgt af et eller flere tilvalg, på denne måde: ifind:tilvalg mønster. Tilladte tilvalg er: b Søg baglæns. r Lav en søgning med et regulært udtryk. s Udfør versalfølsom søgning. c Søg fra markørens position. Kodefoldning tillader dig at skjule dele af et dokument i editoren, hvilket gør det lettere at få overblik over store dokumenter. I &kate; udføres beregningen af områderne som kan foldes sammen ved at bruge reglerne som angives i definitionerne af syntaksfremhævning, og derfor er det kun tilgængeligt i visse formater, typisk i programkildekode, XML-markering og lignende. De fleste definitioner af syntaksfremhævning som understøtter kodefoldning lader dig også manuelt definere områderne som kan foldes sammen, typisk ved at bruge nøgleordene BEGIN og END. For at bruge kodefoldningsfunktionen, aktiveres foldemarkører ved at bruge menupunktet Vis Vis foldemarkører hvis de ikke allerede er synlige. Foldemarkørfeltet til venstre på skærmen viser en grafisk visning af områderne som kan foldes sammen, med tegnene +/- for at angive mulige handlinger for et givet område: tegnet - betyder at området er ekspanderet, og at klikke på - folder området sammen så tegnet + vises i stedet. Der sørges for fire kommandoer til at håndtere tilstanden af områderne som kan foldes sammen, se menudokumentationen. Hvis du ikke vil bruge kodefoldningsfunktionen kan du deaktivere tilvalget Vis foldemarkører (om tilgængelige) på siden Udseende i indstillingen af editoren. Fra og med version 2.5, understøtter &kate;s editorkomponenten scripter med ECMA-script, også kendt som Javascript. Scripter kan kun bruges via den indbyggede kommandolinje. Kravet er at scriptet placeres i en mappe hvor &kate; kan finde det, sammen med en valgfri .desktop-fil som definerer de tilhørende egenskaber. Den gyldige mappe hedder katepart/scripts i &kde;'s datamapper. Du kan finde datamapperne ved at udføre kommandoen tde-config --path data. Du har oftest i det mindste en system og en personlig datamappe. Naturligvis er scripter i systemdatamappen tilgængelige for alle brugere på systemet, mens de i den personlige mappe kun er tilgængelige for dig selv. Denne funktion er eksperimentel, og kommer formodentlig til at ændres i den fremtidige udvikling. Vi ved at mange vil være skuffede over at man ikke kan tilføje scripter i menuen, eller tildele dem genvejstaster. Vi er kede af dette, men en gang i fremtiden vil det formodentlig komme til at være muligt. Det er også endnu ikke muligt at sende en argumenter til scripter. Hav tålmodighed, så kan det tilføjes i en lys fremtid. Her angives det fuldstændige sæt funktioner og egenskaber som er tilgængelige i objekterne document og view. Desuden kan du naturligvis bruge alle standardobjekt såsom Math, String, Regex og så videre. Når et script køres, er objektet document det nuværende dokument, og objektet view er den nuværende visning. Argumenttyperne bruges naturligvis ikke i Javascript for øjeblikket, de er der kun hvor for at angive hvilken slags værdi som funktionerne forventer sig. debug( streng) [funktion] streng strengen der kommer som uddata Skriver strengen ud på standardfejludskriften med kdDebug(). Et særligt udskriftsområde bruges for udskriften, som indledes med Kate (KJS Scripts):. document.attribute( linje , søjle ); [funktion] uint linje Linjen for positionen hvor attributten findes. uint søjle Søjlen for positionen hvor attributten findes. Returnerer den numeriske identifikator for dokumentpositionen [linje,søjle]. Attributten repræsenterar tekstens synlige udseende eller stil, og bruges også til at beregne syntaksfremhævningen for en bestemt del af teksten i blandet format såsom HTML eller PHP. document.canBreakAt( Char c, uint attribut ); [funktion] c Tegnet der skal testes attribut Attributten på positionen for c. Returnerer om linjebrud er tilladt ved tegnet c med attributten attribut. Resultatet bestemmes ved at forespørge attributten som ejer fremhævningen om hvilke tegn som tillades ved linjebrud. document.canComment( uint start_attribut, uint slut_attribut ); [funktion] start_attribut Attributten i begyndelsen af området som skal ændres til en kommentar. slut_attribut Attributten i slutningen af området som skal ændres til en kommentar. Returnerer om start_attribut og slut_attribut hører til samme syntaksfremhævningssystem. Hvis de gør det, er det fornuftigt. if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) { // 1,0 og 5,0 hører til samme syntaksfremhævningssystem } document.clear(); [funktion] Rydder dokumentet. document.commentStart( uint attribut ); [funktion] attribut Attributten for teksten som strengen commentStart skal hente. Returnerer strengen som kræves for at starte en flerlinjekommentar for tekst med attributten, eller en tom streng hvis flerlinjekommentarer ikke understøttes for den tekst. document.commentMarker( uint attribut ); [funktion] attribut Attributten for teksten som strengen commentMarker skal hente Returnerer strengen som bruges til at markere resten af linjen som en kommentar med attributten, eller en tom streng hvis kommentarer for enkelte linjer ikke understøttes for teksten. document.commentEnd( uint attribut ); [funktion] attribut Attributten for teksten som strengen commentEnd skal hente Returnerer strengen som kræves for at afslutte en flerlinjekommentar for tekst med attributten, eller en tom streng hvis flerlinjekommentarer ikke understøttes for teksten. document.editBegin(); [funktion] Start en redigeringsgruppe. Alle handlinger som udføres inden kaldet editEnd() grupperes som en handling at fortryde. document.editEnd(); [funktion] Afslut en redigeringsgruppe. document.highlightMode; [egenskab:skrivebeskyttet] Navnet på dokumentets fremhævningstilstand, såsom JavaScript eller C++. Hvis ingen syntaksfremhævningstilstand er indstillet for dokumentet, er værdien None. Bemærk at du skal bruge det engelske navn hvis det adskiller sig fra det oversatte. document.indentMode; [egenskab:skrivebeskyttet] Navn på dokumentets indrykningstilstand, såsom normal eller cstyle. Husk at hvis ingen indrykningstilstand er indstillet er værdien none. document.indentWidth; [egenskab:skrivebeskyttet] Indstiller indrykningsbredden sat for dokumentet. Dette bruges kun hvis du indrykker med mellemrum. document.insertLine( uint linje, streng tekst ); [funktion] linje dokumentets linjenummer tekst tekst at indsætte Indsætter en ny linje med teksten tekst på linjen linje. document.insertText( uint linje, uint søjle, streng tekst ); [funktion] linje linjenummeret søjle søjlen tekst teksten som skal indsættes Indsætter teksten tekst på linjen linje og søjlen søjle. document.length(); [funktion] Returnerer dokumentets størrelse i byte. document.lines(); [funktion] Returnerer antal linjer i dokumentet. document.mixedIndent; [egenskab:skrivebeskyttet] En boolesk værdi som angiver om indstillingen for blandet indrykning er aktiv for dokumentet. Hvis dette er tilfældet, optimeres indrykningen til at indeholde en blanding af tabulatortegn og mellemrum, ligesom den som bruges af editoren Emacs. document.removeLine( uint linje ); [funktion] linje linjenummer Fjerner dokumentlinjen linje. document.removeText( uint startlinje, uint startsøjle, uint slutlinje, uint slutsøjle ); [funktion] startlinje angiver startlinjen startsøjle angiver startsøjlen slutlinje angiver slutlinjen slutsøjle angiver slutsøjlen Fjerner tekstområdet fra linjen startlinje og søjlen startsøjle frem til linjen slutlinje og søjlen slutsøjle. document.setText( streng tekst ); [funktion] tekst dokumentets tekst Ændrer hele dokumentets indhold til tekst. document.spaceIndent; [egenskab:skrivebeskyttet] En boolesk værdi som angiver om indrykning med mellemrum er aktiv for dokumentet. Hvis dette er tilfældet, indrykkes dokumentet med indentWidth mellemrum pr niveau, ellers sker indrykning med et tabulatortegn pr niveau. document.textFull(); [funktion] Returnerer hele dokumentets tekst. Hvis teksten omfatter flere linjer er linjebrudstegnet \n. document.textLine( uint linje ); [funktion] linje linjen Returnerer teksten på linjen linje. document.textRange( uint startlinje, uint startsøjle, uint slutlinje, uint slutsøjle ); [funktion] startlinje angiver startlinjen startsøjle angiver startsøjlen slutlinje angiver slutlinjen slutsøjle angiver slutsøjlen Returnerer det angivne tekstområde. Hvis området omfatter flere linjer er linjebrydningstegnet \n. view.clearSelection(); [funktion] Afmarkerer al tekst. view.cursorColumn(); [funktion] Returnerer den nuværende markørsøjle (tabulatortegn ekspanderes). view.cursorColumnReal(); [funktion] Returnerer den nuværende rigtige markørsøjle (tabulatortegn regnes som et tegn). view.cursorLine(); [funktion] Får nuværende markørs linje tilbage. view.hasSelection(); [funktion] Returnerer true hvis visningen indeholder markeret tekst, ellers false. view.removeSelectedText(); [funktion] Fjerner den markerede tekst, hvis visningen har en markering. view.selectAll(); [funktion] Markerer al tekst. view.selection(); [funktion] Returnerer den markerede tekst. Hvis markeringen omfatter flere linjer er linjebrudstegnet \n. view.selectionEndColumn; [egenskab:skrivebeskyttet] Returnerer markeringens afsluttende søjle. view.selectionEndLine; [egenskab:skrivebeskyttet] Returnerer markeringens afsluttende linje. view.selectionStartColumn; [egenskab:skrivebeskyttet] Returnerer markeringens indledende søjle. view.selectionStartLine; [egenskab:skrivebeskyttet] Returnerer markeringens indledende linje. view.setCursorPosition( uint linje, uint søjle ); [funktion] linje Angiver linjen for markøren. søjle Angiver søjlen for markøren. Indstiller indtastningsmarkørens position i visningen til [linje, søjle]. Dette indstiller markørens position på visuel måde, dvs. at et tabulatortegn regnes om til tabwidth afhængig af positionen på linjen. Markørens position bliver synlig. Både linje og søjle begynder på nul. view.setCursorPositionReal( uint linje, uint søjle ); [funktion] linje Angiver linjen for markøren. søjle Angiver søjlen for markøren. Indstiller indtastningsmarkørens position i visningen til [linje, søjle]. Dette indstiller strengpositionen, dvs. at et tabulatortegn regnes som 1. Markørens position bliver synlig. Både linje og søjle begynder på nul. view.setSelection( uint startlinje, uint startsøjle, uint slutlinje, uint slutsøjle ); [funktion] startlinje angiver startlinjen startsøjle angiver startsøjlen slutlinje angiver slutlinjen slutsøjle angiver slutsøjlen Opretter en markering fra linjen startlinje og søjlen startsøjle frem til linjen slutlinje og søjlen slutsøjle. Som et eksempel laver vi et lille script som laver markeringen om til store bogstaver. Det er åbenbart at vi først skal kontrollere om en markering findes. Hvis dette er tilfældet, henter vi teksten, ændrer den til store bogstaver og erstatter den med den nye. En implementering skulle kunne se sådan her ud: if ( view.hasSelection() ) { // laver markeringen om til store bogstaver column = view.selectionStartColumn; line = view.selectionStartLine; selection = view.selection().toUpperCase(); document.editBegin(); view.removeSelectedText(); document.insertText( line, column, selection ); document.editEnd(); } For at gruppere handlingerne sammen så de fortrydes med en enkelt aktivering af Fortryd, indkapsler vi linjerne view.removeSelectedText() og document.insertText() med document.editBegin() og document.editEnd(). Her er et eksempel på en .desktop-fil som følger med scriptet ovenfor. # Eksempel på en .desktop-fil [Desktop Entry] Encoding=UTF-8 Name=Kate Part JavaScript Uppercase Comment=Script to uppercase the selection X-Kate-Command=uppercase-selection X-Kate-Help=<p>Usage: <code>uppercase-selection</code></p> Som du kan se kan du definere tegnsættet, angive et navn, en kommentar, en hjælpetekst med X-Kate-Help og kommandolinjenavnet via X-Kate-Command. Indgangene Name, Comment og X-Kate-Help oversættes automatisk til andre sprog af KDE's oversættelsesgrupper, hvis filerne findes i KDE's SVN-arkiv. &kate; søger i scriptmapperne (se ovenfor) efter filerne *.js. For hver fil kontrolleres om der findes en tilsvarende .desktop-fil. I tilfældet uppercase.js ville der blive ledt efter uppercase.desktop. Hvis en .desktop-fil ikke kan findes, registreres scriptet på kate-partens kommandolinje med filnavnet uden det afsluttende .js, så i vort tilfælde ville det være uppercase. Hvis kommandonavnet er godt, og du ikke behøver de ekstra funktioner som en .desktop-fil sørger for behøver du ikke en .desktop-fil i det hele taget. Hvis en .desktop-fil findes, læser kate-parten navnet som scriptet skal registreres som fra indgangen X-Kate-Command i .desktop-filen, for eksempel X-Kate-Command=uppercase-selection.