Avancerade redigeringsverktyg

Kommentera/avkommentera
Kommandona Kommentera och Avkommentera, som är tillgängliga i menyn Verktyg, låter dig lägga till eller ta bort kommentarmarkeringar i den markerade texten, eller den nuvarande raden, om ingen text är markerad, om kommentarer stöds av textformatet som du redigerar.
Reglerna för hur kommentarer ser ut definieras av syntaxdefinitionerna, så om syntaxfärgläggning inte används, så är det inte möjligt att kommentera eller avkommentera.
Vissa format definierar kommentarmarkeringar för enstaka rader, vissa för flera rader och vissa både ock. Om kommentarmarkeringar för flera rader inte är tillgängliga, så är det inte möjligt att kommentera en markering där den sista raden inte ingår helt och hållet.
Om det finns en kommentarmarkering för enstaka rader, så föredras kommentarer för enstaka rader när det är möjligt, eftersom detta hjälper till att undvika problem med nästlade kommentarer.
När kommentarmarkeringar tas bort, så ska inte någon okommenterad text markeras. När kommentarmarkeringar för flera rader tas bort från en markering, så ignoreras eventuella blanktecken utanför kommentarmarkeringen.
För att lägga till kommentarmarkeringar, använd menyalternativet Verktyg Kommentera eller motsvarande snabbtangent, som normalt är D.
För att ta bort kommentarmarkeringar, använd menyalternativet Verktyg Avkommentera eller motsvarande snabbtangent, som normalt är Skift D.

Editorkomponentens kommandorad
s editorkomponent har en intern kommandorad, som låter dig utföra vissa åtgärder från ett minimalt grafiskt gränssnitt. Kommandoraden är ett textinmatningsfält längst ner i redigeringsområdet. För att visa den, välj Visa Byt till kommandorad eller använd snabbtangenten (normalt F7). Editorn tillhandahåller en uppsättning kommandon som är dokumenterade nedan, och ytterligare kommandon kan tillhandahållas av insticksprogram.
Skriv in kommandot och tryck på returtangenten för att utföra det. Kommandoraden anger om kommandot lyckades och visar kanske ett meddelande. Om du kom till kommandoraden genom att trycka på F7 döljs den automatiskt efter några sekunder. För att rensa meddelandet och skriva in ett nytt kommando, tryck på F7 igen.
Kommandoraden har ett inbyggt hjälpsystem, skriv in kommandot help för att komma igång. För att se en lista med alla tillgängliga kommandon, skriv in help list. För att visa hjälp om ett visst kommando, skriv help kommando.
Kommandoraden har en inbyggd historik, så att du kan återanvända kommandon som redan skrivits in. För att navigera i historiken, använd tangenterna Uppåtpil och Neråtpil. När historikkommandon visas är kommandots argument markerade, vilket låter dig enkelt skriva över argumenten.

Vanliga kommandon på kommandoraden

Argumenttyper
BOOLESK 	Denna används med kommandon som sätter på eller stänger av någonting. Möjliga värden är on (på), off (av), true (sant), false (falskt), 1 eller 0.
HELTAL 	Ett heltal.
STRÄNG 	En sträng, omgiven av enkla citationstecken (') eller dubbla citationstecken (") när den innehåller mellanslag.

Kommandon för att anpassa editorn
Dessa kommandon tillhandahålls av editorkomponenten och låter dig bara anpassa det aktiva dokumentet och vyn. Det är praktiskt om du vill använda en inställning som skiljer sig från den förvalda inställningen, till exempel för indentering.
set-tab-width HELTAL bredd
	Ställer in tabulatorbredden till talet bredd.
set-indent-width HELTAL bredd
	Ställer in indenteringsbredden till talet bredd. Används bara om du indenterar med mellanslag.
set-word-wrap-column HELTAL bredd
	Ställer in radbredden för hård radbrytning till bredd. Detta används om du använder automatisk radbrytning för din text.
set-icon-border BOOLESK aktivera
	Ställer in synligheten hos ikonkanten.
set-folding-markers BOOLESK aktivera
	Ställer in synligheten hos vikmarkörrutan.
set-line-numbers BOOLESK aktivera
	Ställer in synligheten hos radnummerrutan.
set-replace-tabs BOOLESK aktivera
	Om aktiverad, ersätts tabulatortecken med mellanslag medan du skriver.
set-remove-trailing-space BOOLESK aktivera
	Om aktiverad, tas avslutande blanktecken bort så fort markören lämnar en rad.
set-show-tabs BOOLESK aktivera
	Om aktiverad, synliggörs tabulatortecken och avslutande blanktecken med en liten punkt.
set-show-indent BOOLESK aktivera
	Om aktiverad, synliggörs indentering av en vertikal punktlinje.
set-indent-spaces BOOLESK aktivera
	Om aktiverad, indenterar editorn med indenteringsbredd mellanslag för varje indenteringsnivå, istället för ett tabulatortecken.
set-mixed-indent BOOLESK aktivera
	Om aktiverad, använder en blandning av tabulatortecken och mellanslag för indentering. Varje indenteringsnivå har bredden indenteringsbredd, och fler indenteringsnivåer optimeras så att så många tabulatortecken som möjligt används.
När det utförs aktiverar kommandot dessutom indentering med mellanslag, och om indenteringsbredden inte anges ställs den in till halva tabulatorbredden för dokumentet.
set-word-wrap BOOLESK aktivera
	Aktiverar dynamisk radbrytning enligt aktivera.
set-replace-tabs-save BOOLESK aktivera
	Om aktiverad, ersätts tabulatortecken med blanktecken så fort dokumentet sparas.
set-remove-trailing-space-save BOOLESK aktivera
	Om aktiverad, tas avslutande mellanslag bort från alla rader så fort dokumentet sparas.
set-indent-mode STRÄNG namn
	Ställer in automatiskt indenteringsläge till namn. Om namn inte känns igen, ställs läget in till 'none'. Giltiga lägen är 'none', 'normal', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' och 'xml'.
set-auto-ident BOOLESK skript
	Aktivera eller inaktivera automatisk indentering.
set-highlight STRÄNG färgläggning
	Ställer in dokumentets syntaxfärgläggningssystem. Argumentet måste vara ett giltigt färgläggningsnamn, som visas i menyn Verktyg Färgläggning. Kommandot tillhandahåller en lista för automatisk komplettering av dess argument.
reload-scripts
	Läs in alla Javascript-skript som används av Kate, inklusive indenterare och kommandoradskript.
set-mode STRÄNG läge
	Välj filtypschema för aktuellt dokument.
nn[oremap] STRÄNG original STRÄNG avbildad
	Avbilda tangentsekvensen original till avbildad.

Kommandon för redigering
Dessa kommandon ändrar aktuellt dokument.
indent
	Indenterar de markerade raderna eller den nuvarande raden.
unindent
	Avindenterar markerade rader eller nuvarande rad.
cleanindent
	Rensar indenteringen för markerade rader eller nuvarande rad enligt dokumentets indenteringsinställningar.
comment
	Infogar kommentarmarkeringar för att göra markeringen, markerade rader eller nuvarande rad en kommentar enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.
uncomment
	Tar bort kommentarmarkeringar från markeringen, markerade rader eller nuvarande rad enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.
kill-line
	Tar bort den nuvarande raden.
replace STRÄNG mönster STRÄNG ersättning
	Ersätter text som matchar mönster med ersättning. Om du vill att mönster ska innehålla blanktecken, måste både mönster och ersättning placeras inom enkla eller dubbla citationstecken. Om argumenten inte är citerade, används det första ordet som mönster och resten som ersättning. Om ersättning är tom, tas varje förekomst av mönster bort.
Du kan anpassa kommandot genom att lägga till ett kolon följt av en eller flera bokstäver som var och en representerar en inställning, genom att ange replace:alternativ mönster ersättning. Tillgängliga alternativ är:
b 	Sök bakåt.
c 	Sök från markörens position.
e 	Sök bara i markeringen.
r 	Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda \N, där N är ett tal, för att representera hittad text i ersättningssträngen.
s 	Utför skiftlägeskänslig sökning.
p 	Fråga efter tillåtelse att ersätta nästa förekomst.
w 	Matcha bara hela ord.
date STRÄNG format
	Infogar en datum- och tidssträng som definieras av angivet format, eller formatet yyyy-MM-dd hh:mm:ss om inget anges. Följande översättningar görs när format tolkas:
d	Dagen som ett tal utan inledande nolla (1-31).
dd	Dagen som ett tal med inledande nolla (01-31).
ddd	Dagens förkortade lokala namn (t.ex. 'mån', 'sön').
dddd	Dagens långa lokala namn (t.ex. 'måndag', 'söndag').
M	Månaden som ett tal utan inledande nolla (1-12).
MM	Månaden som ett tal med inledande nolla (01-12).
MMMM	Månadens långa lokala namn (t.ex. 'januari', 'december').
MMM	Månadens förkortade lokala namn (t.ex. 'jan', 'dec').
yy	Året som ett tal med två siffror (00-99).
yyyy	Året som ett tal med fyra siffror (1752-8000)
h	Timman utan inledande nolla (0-23 eller 1-12 om FM/EM visas).
hh	Timman med inledande nolla (00-23 eller 01-12 om FM/EM visas).
m	Minuten utan inledande nolla (0-59).
mm	Minuten med inledande nolla (00-59).
s	Sekunden utan inledande nolla (0-59).
ss	Sekunden med inledande nolla (00-59).
z	Millisekunden utan inledande nolla (0-999).
zzz	Millisekunden med inledande nolla (000-999).
AP	Använd FM/EM visning. AP ersätts antingen av "FM" eller "EM".
ap	Använd fm/em visning. ap ersätts antingen av "fm" eller "em".
char STRÄNG identifierare
	 Det här kommandot låter dig infoga enskilda tecken med deras numeriska kod, på decimal, oktal eller hexadecimal form. För att använda det, starta dialogrutan för redigeringskommandot och skriv char: [nummer] i inmatningsrutan, och tryck sedan på Ok.

Exempel på användning av char
Inmatning: char:234
Utmatning: ê
Inmatning: char:0x1234
Utmatning: ሴ
s///[ig] %s///[ig] 	 Det här kommandot söker och ersätter på ett sätt som liknar sed, för den nuvarande raden, eller för hela filen (%s///).
I kortet, så söks texten igenom efter en text som matchar sökmönstret, det reguljära uttrycket mellan det första och andra snedstrecket, och vid en träff så ersätts texten med uttrycket mellan det andra och sista snedstrecket. Parenteser i sökmönstret skapar bakåtreferenser, det vill säga kommandot kommer ihåg vilken del av strängen som matchade inom parenteserna. Strängarna kan återanvändas i ersättningsmönstret, med referenserna \1, för första paret parenteser, \2 för det andra, och så vidare.
För att söka efter tecknen ( eller ), måste du undanta dem med ett bakstreckstecken \(\).
Om du lägger till i sist i uttrycket, blir matchningen skiftlägesokänslig. Om du lägger till g sist, ersätts alla förekomster av mönstret, annars ersätts bara den första förekomsten.

Ersätta text på den nuvarande raden
Din vänliga kompilator stannade just, och talade om för dig att klassen minKlass som nämns på rad 3902 i din källkodsfil inte är definierad.
"Tusan också!" tänker du. Det ska förstås vara MinKlass. Du går till rad 3902, och istället för att försöka hitta ordet i texten, så startar du dialogrutan för redigeringskommandot, och skriver in s/minklass/MinKlass/i, trycker på knappen Ok, sparar filen och kompilerar – utan problem med felet borta.

Ersätta text i hela filen
Antag att du har en fil där du nämner namnet Anna Johansson flera gånger, och någon kommer in och talar om för dig att hon precis har gift sig och bytt namn till Anna Svensson. Du vill, förstås, byta ut alla förekomster av Anna Johansson mot Anna Svensson.
Starta kommandoraden, och skriv in kommandot: %s/Anna Johansson/Anna Svensson/, tryck på returtangenten och du är klar.

Ett mer avancerat exempel
Det här exemplet använder bakåtreferenser samt en ordklass (om du inte vet vad det är, se tillhörande dokumentation som nämns nedan).
Antag att du har följande rad:

void MyClass::DoStringOps( String      &foo, String &bar, String *p, int  &a, int &b )

Nu inser du att det inte är bra kod, och bestämmer dig för att du vill använda nyckelordet const för alla adress- parametrar, de som markeras med operatorn & framför argumentets namn. Du skulle också vilja förenkla blanktecknen, så att det bara finns ett blanktecken mellan varje ord.
Starta dialogrutan för redigeringskommandot, skriv in: s/\s+(\w+)\s+(&)/ const \1 \2/g och tryck sedan på knappen Ok. Tecknet g i slutet på raden gör att det reguljära uttrycket görs om för varje träff, så att bakåtreferenserna sparas.
Utmatning: void MinKlass::DoStringOps( const String &x, const String &y String *p, const int &a, const int &b )
Åtgärden utförd! Vad hände nu egentligen? Ja, vi letade efter blanktecken (\s+), följt av en eller flera bokstäver (\w+), följt av ytterligare blanktecken (\s+), följt av ett och-tecken, och sparade bokstäverna samt och-tecknet för att återanvända i ersättningsoperationen. Därefter ersatta vi den matchande delen av vår rad, med ett blanktecken följt av const, följt av ett blanktecken, följt av våra sparade bokstäver (\1), följt av vårt sparade och-tecken (\2)
I vissa fall var bokstäverna String, i andra int, så att använda teckenklassen \w och tecknet + visade sig vara en värdefull tillgång.
sort
	Sorterar den markerade texten eller hela dokumentet.
natsort
	Sorterar de markerade raderna eller hela dokumentet i naturlig ordning.

sort mot natsort
sort(a10, a1, a2) ger resultatet a1, a10, a2
natsort(a10, a1, a2) ger resultatet a1, a2, a10
moveLinesDown
	Flytta markerade rader neråt.
moveLinesUp
	Flytta markerade rader uppåt.
uniq
	Ta bort duplicerade rader från den markerade texten eller hela dokumentet.
rtrim
	Ta bort avslutande blanktecken från den markerade texten eller hela dokumentet.
ltrim
	Ta bort inledande blanktecken från den markerade texten eller hela dokumentet.
join STRÄNG separator
	Sammanfoga markerade linjer eller hela dokumentet. Har en valfri parameter som definierar ett separatortecken, till exempel: join ','.
rmblank
	Ta bort alla blanktecken från den markerade texten eller hela dokumentet.
unwrap
	Ta bort radbrytning för markerad text eller hela dokumentet.
each STRÄNG skript
	Givet en Javascript-funktion som argument, anropa den för listan med markerade rader och ersätt dem med returvärdet från anropet.

Sammanfoga markerade linjer
each 'function(lines){return lines.join(", ")}'
Eller, kortare:
each 'lines.join(", ")'
filter STRÄNG skript
	Givet en Javascript-funktion som argument, anropa den för listan med markerade rader och ta bort de där anropet returnerar falskt.

Ta bort tomma linjer
filter 'function(1){return 1.length > 0;}'
Eller, kortare:
filter 'line.length > 0'
map STRÄNG skript
	Givet en Javascript-funktion som argument, anropa den för listan med markerade rader och ersätt raden med värdet från anropet.

Ta bort tomma linjer
map 'function(line){return line.replace(/^s+/,"");}'
Eller, kortare:
map 'line.replace(/^s+/,"")'
duplicateLinesUp
	Duplicera markerade rader ovanför den nuvarande markeringen.
duplicateLinesDown
	Duplicera markerade rader nedanför den nuvarande markeringen.

Kommandon för navigering
goto HELTAL rad
	Det här kommandot går till den angivna raden.
grep STRÄNG mönster
	Sök i dokumentet efter det reguljära uttrycket mönster. För mer information, se
find STRÄNG mönster
	Kommandot går till första förekomsten av mönster enligt inställningen. Följande förekomster kan hittas genom att använda Redigera Sök igen (normal snabbtangent är F3).
Kommandot kan anpassas genom att lägga till ett kolon följt av ett eller flera alternativ. Formatet är find:alternativ mönster. Följande alternativ stöds:
b 	Sök bakåt.
c 	Sök från markörens position.
e 	Sök bara i markeringen.
r 	Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda \N, där N är ett tal, för att representera hittad text i ersättningssträngen.
s 	Utför skiftlägeskänslig sökning.
w 	Matcha bara hela ord.
ifind STRÄNG mönster
	Kommandot tillhandahåller sökning medan du skriver. Du kan ställa in beteendet eller sökningen genom att lägga till ett kolon följt av ett eller flera alternativ, på detta sätt: ifind:alternativ mönster. Tillåtna alternativ är:
b 	Sök bakåt.
r 	Gör en sökning med ett reguljärt uttryck.
s 	Utför skiftlägeskänslig sökning.
c 	Sök från markörens position.

Kommandon för grundläggande redigeringsfunktioner (dessa beror på programmet som editorkomponenten används i)
w
	Spara aktuellt dokument.
wa
	Spara alla dokument som för närvarande är öppna.
q
	Stäng aktuellt dokument.
qa
	Stäng alla öppna dokument.
wq
	Spara och stäng aktuellt dokument.
wqa
	Spara och stäng alla dokument som för närvarande är öppna.
x
	Spara och stäng aktuellt dokument, men bara om det har ändrats.
x
	Spara och stäng alla dokument som för närvarande är öppna, men bara om de har ändrats.
bp
	Gå till föregående dokument i dokumentlistan.
bn
	Gå till nästa dokument i dokumentlistan.
new
	Öppna ett nytt dokument i en horisontellt delad vy.
vnew
	Öppna ett nytt dokument i en vertikalt delad vy.
e
	Läs in aktuellt dokument om det har ändrats på disk.
enew
	Redigera ett nytt dokument.
print
	Öppna utskriftsdialogrutan för att skriva ut det aktuella dokumentet.

Använda kodvikning
Kodvikning låter dig dölja delar av ett dokument i editorn, vilket gör det lättare att få en överblick av stora dokument. I görs beräkningen av områden som kan fällas ihop genom att använda reglerna som anges i definitionerna av syntaxfärgläggning, och därför är det bara tillgängligt i vissa format, typiskt i programkällkod, XML-markering och liknande. De flesta definitioner av syntaxfärgläggning som stöder kodvikning låter dig också manuellt definiera områden som kan fällas ihop, typiskt genom att använda nyckelorden BEGIN och END.
För att använda kodvikningsfunktionen, aktivera vikmarkörer genom att använda menyalternativet Visa Visa vikmarkörer om de inte redan är synliga. Vikmarkörrutan till vänster på skärmen visar en grafisk vy av områden som kan fällas ihop, med triangelsymboler för att ange möjliga åtgärder för ett givet område: en triangel med spetsen neråt betyder att området är expanderat, och att klicka på den fäller ihop området så att en triangel som pekar åt höger visas istället.
Tre kommandon tillhandahålls för att hantera tillståndet hos områden som kan fällas ihop, se menydokumentationen.
De ihopfällda raderna blir ihågkomna när en fil stängs, så när filen öppnas igen är de ihopfällda delarna fortfarande ihopfällda. Det gäller också vid uppdatering.
Om du inte vill använda kodvikningsfunktionen kan du inaktivera alternativet Visa vikmarkörer (om tillgängliga) på sidan Utseende i editorns inställningar.