# Handbok &kwrite;

## Inledning

&kwrite; är mer än en texteditor för &kde;-skrivbordet. Den är avsedd som en editor för programmerare, och kan delvis anses som ett alternativ till mer kraftfulla editorer. Den kan vara bäst att använda tillsammans med &konqueror; för att bläddra i källkodsfiler med olika språk. &kwrite; fungerar också mycket bra som en enkel texteditor. En av &kwrite;s huvudfunktioner är syntaxfärgläggningen, som är anpassad för många olika programspråk som C/C++, &Java;, Python, Perl, Bash, Modula 2, &HTML; och Ada.

## En del grundläggande information

&kwrite; är mycket lätt att använda. Alla som har använt en texteditor bör inte ha några problem.

### Drag och släpp

&kwrite; använder &kde;:s drag och släpp protokoll. Filer kan dras och släppas på &kwrite; från skrivbordet, &konqueror;, eller någon &FTP;-plats som öppnats i ett av &konqueror;s fönster.

### Kommandoradsväljare

Även om &kwrite; oftast startas från &kde;:s programmeny, eller en skrivbordsikon, kan den också köras från kommandoraden i ett terminalfönster. Det finns ett antal användbara väljare som är tillgängliga när detta görs.

#### Ange en fil

Genom att ange sökvägen och namnet på en särskild fil kan användaren låta &kwrite; öppna (eller skapa) filen omedelbart vid uppstart. Det här kan se ut som följer:

    % kwrite
    /home/mitthem/dokument/minfil.txt

#### Ange en fil på Internet

Det ovanstående sättet kan till och med användas för att öppna filer på Internet (om användaren har en aktiv anslutning vid detta tillfället). Ett exempel på det här kan se ut som följer:

    % kwrite
    ftp://ftp.kde.org/pub/kde/Welcome.msg

#### Andra kommandoradsväljare

Följande hjälpalternativ är tillgängliga på kommandoraden

``kwrite` `--help``

- Visar de mest grundläggande alternativen som är tillgängliga från kommandoraden.

``kwrite` `--help-qt``

- Visar alternativen som är tillgängliga för att ändra hur &kwrite; samarbetar med &Qt;.

``kwrite` `--help-kde``

- Visar alternativen som är tillgängliga för att ändra hur &kwrite; samarbetar med &kde;.

``kwrite` `--help-all``

- Visar alla kommandoradsväljare.

``kwrite` `--author``

- Visar &kwrite;s upphovsmän i terminalfönstret.

``kwrite` `--version``

- Visar information om versioner för &Qt;, &kde; och &kwrite;. Också tillgängligt med ``kwrite` `-v``.

``kwrite` `--stdin``

- Gör att &kwrite; läser dokumentets innehåll från standardinmatningen. Det liknar den vanliga väljaren `-` som används av många kommandoradsprogram, och låter dig skicka utdata från ett kommando till &kwrite; via en rörledning.

``kwrite` `--encoding` `kodning` `webbadress``

- Gör att &kwrite; använder angiven kodning för dokumentet.

``kwrite` `--line` `rad` `webbadress``

- Går till angiven rad efter att dokumentet har öppnats.

``kwrite` `--column` `kolumn` `webbadress``

- Går till angiven kolumn efter att dokumentet har öppnats.

### Genvägar

Många av genvägarna kan anpassas via menyn Inställningar. Normalt hanterar &kwrite; följande genvägar:

Insert | Växla mellan lägena infoga och ersätt. I läget infoga lägger editorn till alla tecken som skrivs in till texten medan all data knuffas framåt till höger om textmarkören. Läget ersätt gör att varje tecken som skrivs in ersätter tecknet omedelbart till höger om textmarkören.
Vänsterpil | Flytta markören ett tecken åt vänster.
Högerpil | Flytta markören ett tecken åt höger.
Uppåtpil | Flytta markören en rad uppåt.
Neråtpil | Flytta markören en rad neråt.
Page Up | Flytta markören en sida uppåt.
&Alt;Page Up | Föregående bokmärke
Page Down | Flytta markören en sida neråt.
&Alt;Page Down | Nästa bokmärke
Backsteg | Ta bort tecknet till vänster om markören.
Home | Flytta markören till början av raden.
End | Flytta markören till slutet av raden.
Delete | Ta bort tecknet till höger om markören (eller all markerad text).
Skift vänsterpil | Markera text ett tecken åt vänster.
Skift högerpil | Markera text ett tecken åt höger.
F1 | Hjälp
Skift F1 | Vad är det här?
F3 | Sök igen
&Shift;F3 | Sök föregående
&Ctrl;A | Markera alla
&Ctrl;&Shift;A | Avmarkera
&Ctrl;&Shift;B | Blockmarkeringsläge
&Ctrl;B | Lägg till ett bokmärke
&Ctrl;C | Kopiera den markerade texten till klippbordet.
&Ctrl;D | Kommentar
&Ctrl;&Shift;D | Avkommentera
&Ctrl;F1 | Sök
&Ctrl;G | Gå till rad...
&Ctrl;I | Indentera markering
&Ctrl;&Shift;I | Avindentera markering
&Ctrl;J | Kombinera rader
&Ctrl;N | Nytt dokument
&Ctrl;O | Öppna ett dokument
&Ctrl;P | Skriv ut
&Ctrl;Q | Avsluta. Stäng aktiv kopia av editorn
&Ctrl;R | Ersätt
&Ctrl;S | Utför kommandot Spara.
&Ctrl;U | Stora bokstäver
&Ctrl;&Shift;U | Små bokstäver
&Alt;&Ctrl;U | Inledande stor bokstav
&Ctrl;V | Klistrar in klippbordets text på raden som redigeras.
&Ctrl;W | Stäng
&Ctrl;X | Klipp ut den markerade texten, och kopiera den till klippbordet.
&Ctrl;Z | Ångra
&Ctrl;Skift Z | Gör om
&Ctrl;- | Fäll ihop en lokal nivå
&Ctrl;&Shift;- | Fäll ihop toppnivå
&Ctrl;+ | Expandera en lokal nivå
&Ctrl;&Shift;+ | Expandera toppnivå
F5 | Uppdatera
F6 | Visa/Dölj ikonkant
F7 | Byt till kommandorad
F9 | Visa/Dölj vikmarkörer
F10 | Dynamisk radbrytning
F11 | Visa/Dölj radnummer

## Menyalternativen

### Menyn Arkiv

&Ctrl;N Arkiv Ny

- Det här startar ett nytt dokument i editorn. Om det finns ett aktuellt dokument med ändringar som inte har sparats får användaren en chans att spara det.

&Ctrl;O Arkiv Öppna...

- Visar den vanliga dialogrutan Öppna fil i &kde;. Använd filvyn för att välja filen du vill öppna, och klicka på Öppna för att öppna den. Du hittar mer information om dialogrutan Öppna fil i &kde; i &kde;:s användarhandbok.

Arkiv Öppna senaste

- Det här är en genväg för att öppna nyligen sparade dokument. Genom att klicka på det här alternativet öppnas en lista vid sidan om menyn med flera av de senast sparade filerna. Genom att klicka på en specifik fil öppnas den i &kwrite;, om filen fortfarande finns på samma plats.

&Ctrl;S Arkiv Spara

- Det här sparar det nuvarande dokumentet. Om dokumentet redan har sparats skriver det här över den tidigare sparade filen utan att fråga efter användarens samtycke. Om det här är första gången ett nytt dokument sparas, visas dialogrutan Spara som (beskrivs nedan).

Arkiv Spara som...

- Det här låter ett dokument sparas med ett nytt filnamn. Det här görs med fildialogrutan som beskrivs ovan under avsnittet Öppna i den här hjälpfilen.

F5 Arkiv Återställ

- Laddar den aktiva filen igen. Kommandot är användbart om ett annat program eller en annan process har ändrat filen medan den varit öppen i &kwrite;.

&Ctrl;P Arkiv Skriv ut...

- Öppnar en enkel utskriftsdialog, som låter användaren ange vad, vart och hur utskrift ska ske.

Arkiv Exportera som HTML...

- Exportera filen med HTML-format så att dokumentet kan visas som en webbsida.

&Ctrl;W Arkiv Stäng

- Stäng aktuell fil med det här kommandot. Om du har gjort osparade ändringar, kommer du att få en fråga om du vill spara ändringarna innan &kwrite; stänger filen.

&Ctrl;Q Arkiv Avsluta

- Det här stänger editorfönstret. Om du har mer än en instans av &kwrite; startad, genom menyalternativen Ny vy eller Nytt fönster, så stängs inte de instanserna.

### Menyn Redigera

&Ctrl;Z Redigera Ångra

- Det här används för att eliminera eller ångra den senaste användaråtgärden eller operationen.

&Ctrl;&Shift;Z Redigera Gör om

- Det här återställer den senaste ändringen (om det finns någon) som gjorts med Ångra.

&Ctrl;X Redigera Klipp ut

- Det här kommandot tar bort den nuvarande markerade texten och placerar den på klippbordet. Klippbordet är en funktion i &kde; som osynligt fungerar för att erbjuda ett sätt att överföra data mellan program.

&Ctrl;C Redigera Kopiera

- Det här kopierar den nuvarande markerade texten till klippbordet så att den kan klistras in någon annanstans. Klippbordet är en funktion i &kde; som osynligt fungerar för att erbjuda ett sätt att överföra data mellan program.

Redigera Kopiera som HTML

- Det här kopierar texten som för närvarande är markerad till klippbordet som HTML.

&Ctrl;V Redigera Klistra in

- Det här infogar innehållet på klippbordet vid markörens position. Klippbordet är en funktion i &kde; som osynligt fungerar för att erbjuda ett sätt att överföra data mellan program.

&Ctrl;A Redigera Markera allt

- Det här väljer hela dokumentet. Det här kan vara mycket användbart för att kopiera hela filen till ett annat program.

&Ctrl;&Shift;A Redigera Avmarkera

- Avmarkerar den markerade texten i editorn, om det finns någon.

&Ctrl;&Shift; B Redigera Blockmarkeringsläge

- Växlar markeringsläge. När markeringsläget är "BLOCK", kan du göra vertikala markeringar, t.ex. markera kolumn 5 till 10 på rad 9 till 15. Statusraden visar markeringslägets nuvarande status, antingen "NORM" eller "BLOCK".

Insert Redigera Överskrivningsläge

- Växlar mellan infoga och skriv över. När läget är "INFOGA", infogar du tecken där markören befinner sig. När läget är "ERSÄTT" ersätter inskrivna tecken de nuvarande tecknen om markören är placerad före några tecken. Statusraden visar aktuell status av skriv över, antingen "INFOGA" eller "ERSÄTT".

&Ctrl;F Redigera Sök

- Det här öppnar sökdialogrutan som används för att ange texten att Söka efter i dokumentet. Det finns en liten textruta för att skriva in sökmönstret som också fungerar som en kombinationsruta. Genom att klicka på pilen vid sidan om rutan visas andra nyligen använda sökmönster. Andra alternativ ingår för att göra sökningen effektivare. Genom att välja Skiftlägeskänslig begränsas sökningen så att stora och små bokstäver matchas för varje tecken i sökmönstret. Sök baklänges anger att sökningen ska ske i riktning uppåt. Alternativet Markerad text håller sökningen inom den nuvarande markerade texten. Genom att markera Endast hela ord förhindras sökningen att stanna på ord som innehåller mönstret som eftersöks. Alternativet Från början börjar sökningen från början av dokumentet istället för från den nuvarande positionen för markören i dokumentet.

F3 Redigera Sök igen

- Det här upprepar den senaste sökningen, om det finns någon, utan att anropa sökdialogrutan.

&Shift;F3 Redigera Sök föregående

- Det här upprepar den senaste sökningen, om det finns någon, utan att anropa sökdialogrutan, och söker bakåt istället för framåt igenom dokumentet.

&Ctrl;R Redigera Ersätt...

- Det här kommandot öppnar ersättningsdialogrutan. Ersättningsdialogrutan är nästan identiskt lik den ovannämnda sökdialogrutan. Förutom funktionerna i sökdialogrutan innehåller den text- och kombinationsrutan Ersätt med:. Genom att använda den här dialogrutan kan användaren både ange texten som ska sökas efter och texten som den ska ersättas med. Det ytterligare alternativet Fråga vid ersättning låter användaren välja att &kwrite; frågar efter bekräftelse innan varje ersättning.

&Ctrl;G Redigera Gå till rad

- Det här öppnar dialogrutan för att gå till en rad, som används för att få markören att ställa sig på en särskild rad (som anges med ett tal) i dokumentet. Radnumret kan skrivas in direkt i textrutan eller anges grafiskt genom att klicka på uppåt- eller neråtpilarna vid sidan av textrutan. Den lilla uppåtpilen ökar radnumret och nedåtpilen minskar det. Det finns också ett skjutreglage till höger om textrutan som låter användaren flytta positionen att gå till i dokumentet på ett liknande sätt.

### Menyn Visa

Menyn Visa låter dig hantera inställningar som är specifika för den aktiva editorn, och hantera ramar.

Visa Nytt fönster

- Öppnar ett nytt fönster med samma text.

F7 Visa Byt till kommandorad

- Visar Kate-delens kommandorad längst ner i fönstret. Skriv "help" på kommandoraden för att få hjälp, och "help list" för att få en lista med kommandon.

Visa Schema

- Välj ett teckensnittsschema.

F10 Visa Dynamisk radbrytning

- Textraderna radbryts vid vyns kant på skärmen.

F10 Visa Dynamiska radbrytningsmarkörer

- Välj när och hur dynamiska radbrytningsmarkörer ska visas. Det är bara tillgängligt om alternativet Dynamisk radbrytning är markerat.

Visa Visa statisk radbrytningsmarkör

- Om det här alternativet är markerat, ritas en vertikal linje i radbrytningskolumnen som definieras i Inställningar Anpassa editor... under fliken Redigering. Observera att radbrytningsmarkören bara ritas om du använder ett teckensnitt med fast breddsteg.

F6 Visa Visa ikonkant

- Det här är ett alternativ som växlar. Om det aktiveras, visas ikonkanten för den aktiva editorn, och vice versa.

F11 Visa Visa radnummer

- Det här är ett alternativ som växlar. Om det aktiveras, visas en ruta med radnummer längs vänsterkanten på den aktiva editorn, och vice versa.

Visa Visa rullningslistmarkeringar

- Om det här alternativet är markerat visar vyn markeringar på den vertikala rullningslisten.

F9 Dölj vikmarkörer

- Om det här alternativet är markerat, döljs markeringar för kodvikning.

Kodvikning

- Ctrl Skift- Fäll ihop toppnivå

- Fäll ihop alla toppnivåområden i dokumentet.

Ctrl Skift+ Expandera toppnivå

- Expandera alla toppnivåområden i dokumentet.

Ctrl - Fäll ihop en lokal nivå

- Fäll ihop området närmast markören.

Ctrl + Expandera en lokal nivå

- Expandera området närmast markören.

### Menyn Bokmärken

&Ctrl;B Bokmärken Nytt bokmärke

- Lägger till eller tar bort ett bokmärke på den nuvarande raden i det aktiva dokumentet (om det redan finns, tas det bort, annars läggs det till).

Bokmärken Rensa alla bokmärken

- Det här kommandot tar bort alla bokmärken från dokumentet samt listan på bokmärken som läggs till längst ner i det här menyalternativet.

Alt Page Up Bokmärken Föregående

- Det här flyttar markören till början av den första raden ovan med ett bokmärke. Menyalternativets text innehåller radnummer och den inledande texten på raden. Alternativet är bara tillgängligt när det finns ett bokmärke på en rad ovanför markören.

Alt Page Down Bokmärken Nästa

- Det här flyttar markören till början av nästa rad med ett bokmärke. Menyalternativets text innehåller radnummer och den inledande texten på raden. Alternativet är bara tillgängligt när det finns ett bokmärke på en rad nedanför markören.

Längst ner i den här menyn visas en lista med bokmärken om det finns några för det här fönstret.

### Menyn Verktyg

Verktyg Skrivskyddat läge

- Ställer in aktuellt dokument till skrivskyddat läge. Det förhindrar tillägg av all text och alla ändringar av dokumentets formatering.

Verktyg Filtyp

- Välj filtypschema som du föredrar för det aktiva dokumentet. Det skriver över det globala filtypsläget som ställts in i Inställningar Anpassa editor... under fliken Filtyper, men bara för det aktuella dokumentet.

Verktyg Färgläggning

- Välj färgläggningsschema som du föredrar för det aktiva dokumentet. Det skriver över det globala färgläggningsläget som ställts in i Inställningar Anpassa editor..., men bara för det aktuella dokumentet.

Verktyg Indentering

- Välj indenteringsstil som du vill ha för det aktiva dokumentet. Det skriver över det globala indenteringsläget som ställts in i Inställningar Anpassa editor..., men bara för det aktuella dokumentet.

Verktyg Kodning

- Du kan skriva över den förvalda kodningen inställd i Inställningar Anpassa editor... under fliken Öppna/spara för att ange en annan kodning för det aktuella dokumentet. Kodningen du ställer in här är bara giltig för det aktuella dokumentet.

Verktyg Radslut

- Välj radslutsläget som du föredrar för det aktiva dokumentet. Det skriver över det globala radslutsläget som ställts in i Inställningar Anpassa editor..., men bara för det aktuella dokumentet.

Verktyg Stavning

- Det här aktiverar programmet för stavningskontroll: ett program konstruerat för att hjälpa användare hitta och korrigera eventuella stavfel. Att klicka på alternativet startar kontrollen och visar stavningskontrolldialogrutan där användaren kan styra processen. Det finns fyra inställningar vertikalt uppradade i dialogrutans mitt med motsvarande beteckningar omedelbart till vänster. Ovanifrån är de:

  Okänt ord:

- Här anger stavningskontrollen ordet som för närvarande behandlas. Det sker när kontrollen stöter på ett ord som inte finns i dess ordlista: en fil som innehåller en lista med riktigt stavade ord som den jämför varje ord i editorn med.

Ersätt med:

- Om kontrollen har några liknande ord i sin ordbok, kommer det första att visas här. Användaren kan acceptera förslaget, skriva in sin egen rättning, eller välja ett annat förslag från nästa ruta.

Föreslagna ord:

- Kontrollen kan lista ett antal möjliga ersättningar för ordet som hanteras. Genom att klicka på något av förslagen skrivs ordet in i rutan Ersätt med ovanför.

Språk:

- Om du har installerat flera ordlistor, kan du välja vilken ordlista/språk som ska användas.

Till höger i dialogrutan finns fem knappar som låter användaren styra stavningskontrollprocessen. De är:

Lägg till i ordlista

- Genom att trycka på den här knappen läggs ordet i rutan Felstavat ord: till i kontrollens ordbok. Det här betyder att i framtiden kommer kontrollen alltid att anse att det här ordet är rättstavat.

Ersätt

- Den här knappen får kontrollen att ersätta ordet som hanteras i dokumentet med ordet i rutan Ersätt med:.

Ersätt alla

- Den här knappen gör att kontrollen inte bara byter ut det nuvarande okända ordet utan också automatiskt gör samma utbyte för alla andra förekomster av det här okända ordet i dokumentet.

Ignorera

- Genom att aktivera den här knappen kommer kontrollen fortsätta utan att göra några ändringar.

Ignorera alla

- Den här knappen talat om för kontrollen att inte göra något med det nuvarande okända ordet och att hoppa över alla andra förekomster av samma ord.

  Det gäller bara nuvarande körning av stavningskontrollen. Om kontrollen körs igen stannar den på samma ord.

Ytterligare tre knappar är placerade horisontellt längs stavningskontrolldialogrutans underkant. De är:

Hjälp

- Det här startar &kde;:s hjälpsystem med början på &kwrite;s hjälpsidor (det här dokumentet).

Slutförd

- Den här knappen avslutar stavningskontrollprocessen, och återgår till dokumentet.

Avbryt

- Den här knappen avbryter stavningskontrollprocessen, alla ändringar återställs, och du återgår till dokumentet.

Verktyg Stavning (från markör)...

- Det här aktiverar programmet för stavningskontroll, men det startar där markören finns istället för från början i dokumentet.

Verktyg Stavningskontroll av markering...

- Stavningskontrollerar den aktuella markeringen.

&Ctrl;I Verktyg Indentera

- Det här ökar styckets indentering med ett steg. Storleken på steget beror på indenteringsinställningarna.

&Ctrl;&Shift;I Verktyg Avindentera

- Det här minskar styckets indentering med ett steg. Storleken på steget beror på indenteringsinställningarna.

Verktyg Rensa indentering

- Det här rensar indenteringen för nuvarande markering eller för raden där markören för närvarande befinner sig. Att rensa indenteringen försäkrar dig om att den markerade texten följer indenteringsläget du valt.

Verktyg Justera

- Gör att nuvarande rad eller markerade rader justeras om med indenteringsläget och indenteringsinställningarna i dokumentet.

&Ctrl;D Verktyg Kommentera

- Det här lägger till ett blanktecken i början på raden där textmarkören befinner sig eller till början av alla markerade rader.

&Ctrl;&Shift;D Verktyg Avkommentera

- Det här tar bort ett blanktecken (om det finns något) från början på raden där textmarkören befinner sig eller från början av alla markerade rader.

&Ctrl;U Verktyg Stora bokstäver

- Ändra den markerade texten eller bokstaven efter markören till stora bokstäver.

&Ctrl;&Shift;U Verktyg Små bokstäver

- Ändra den markerade texten eller bokstaven efter markören till små bokstäver.

&Alt;&Ctrl;U Verktyg Inledande stor bokstav

- Ändra den inledande bokstaven för orden i den markerade texten eller i aktuellt ord till stor bokstav.

&Ctrl;J Verktyg Kombinera rader

- Kombinerar markerade rader, eller den nuvarande raden och raden under den med ett blanktecken som avskiljare. Inledande eller efterföljande blanktecken tas bort för kombinerade rader i ändarna som påverkas.

Verktyg Bryt rader mellan ord i dokumentet

- Utför statisk radbrytning för hela dokumentet. Det betyder att en ny textrad automatiskt börjar när den nuvarande raden överskrider längden som anges av alternativet Bryt rader vid: under fliken Redigering i Inställningar Anpassa editor....

### Menyn Inställningar

Inställningar Visa verktygsrad

- Om det här är valt visas en flyttbar verktygsrad som innehåller knappar som används för att utföra ofta använda kommandon. Om det inte är valt göms verktygsraden.

Inställningar Visa statusrad

- Om det här är valt, visas en rad längst ner i editorn som innehåller information om status för det nuvarande dokumentet. Om det inte är valt, göms statusraden.

Inställningar Visa sökväg

- Om det här är valt, visas sökvägen för det nuvarande dokumentet (dess plats i filsystemet) i namnlisten. Om det inte är valt, göms sökvägen.

Inställningar Anpassa editor...

- Det här menyalternativet öppnar en dialogruta där flera olika inställningar kan justeras.

Inställningar Välj editor...

- Välj förvald textredigeringskomponent som du vill använda i &kwrite;. Du kan välja Systemstandard, Inbäddningsbar avancerad texteditor eller &Qt; Designer-baserad texteditor (observera att &Qt; Designer-baserad texteditor bara är tillgänglig om du har installerat KDevelop på systemet). Om du väljer Systemstandard, följer &kwrite; dina ändringar i inställningscentralen. Alla andra inställningar överskrider denna inställning.

Inställningar Anpassa genvägar...

- Det här kommandot öppnar en dialogruta som gör att tangentbindningar kan ändras. Ett visningsfönster längst upp i dialogrutan visar en lista på kommandon (åtgärder) som är tillgängliga. Under fönstret finns tre alternativknappar. Användaren kan välja mellan Ingen tangent, Förvald tangent, och Egen tangent. (Observera att en uppsättning med alternativknappar bara tillåter att ett av de tillgängliga valen markeras, på samma sätt som knapparna på en bilradio bara tillåter val av en förinställd station. Dessutom är knappen Förval bara tillgänglig för de kommandon som verkligen har en 'förvald' snabbtangent.) Genom att välja alternativet Egen tangent aktiveras de tre kryssrutorna och tangentknappen längst ner i dialogrutan. Användaren kan därefter välja en kombination av tangenter för kommandot som avses med hjälp av kryssrutorna och tangentknappen. Med till exempel kommandot Om &kde; valt i visningsfönstret, kan användaren välja &Ctrl; och Alt, klicka på tangentknappen, och sedan trycka på K-tangenten på tangentbordet. Det här betyder att så fort han eller hon håller nere Ctrl- och Alt-tangenterna och trycker på K (medan &kwrite; används) kommer rutan Om &kde; visas.

Inställningar Anpassa verktygsrader...

- Det här öppnar dialogrutan som gör att inställningarna för verktygsraden kan ändras. Användaren kan välja vilka genvägsknappar som ska synas i verktygsraden. Ett fönster till vänster listar kommandon tillgängliga för att placera i verktygsraden. Ett fönster till höger listar de kommandon som redan finns i verktygsraden. En uppsättning med fyra pilknappar mellan de två fönstren ändrar valet. Pilen som pekar åt höger placerar ett kommando markerat i vänsterrutan i högerrutan, dvs. det läggs till i verktygsraden. Vänsterpilen gör precis det motsatta, tar bort en åtgärd markerad i högerfönstret från verktygsraden. Uppåt- och neråtpilarna ändrar positionen för en åtgärd som markerats i högerfönstret, vilket ändrar plats för knappen i verktygsraden.

### Menyn Hjälp

&help.menu.documentation;

## Att anpassa &kwrite;

Genom att välja Inställningar Anpassa editor... i menyn visar dialogrutan Anpassa editor. Den här dialogrutan kan användas för att ändra ett antal olika inställningar. Inställningarna som är tillgängliga för att ändras varierar beroende på vilken kategori som användaren väljer i den vertikala listan till vänster i dialogrutan. Förloppet kan styras med de tre knapparna längs rutans nederkant.

Hon eller han kan starta Hjälp-systemet, acceptera de nuvarande inställningarna och stänga dialogrutan med användning av knappen Ok, eller Avbryta förfarandet. Kategorierna Färg, Teckensnitt, Indentering, Markering, Redigering, Rättstavning och Färgläggning beskrivs i detalj nedan.

### Utseende

Radbrytning

- Dynamisk radbrytning

- Om det här alternativet markeras, bryts textrader vid fönstrets kant på skärmen.

Dynamiska radbrytningsmarkörer

- Välj när indikering av dynamisk radbrytning ska visas.

Justera dynamiskt radbrutna rader till indenteringsdjupet:

- Aktiverar att dynamiskt radbrytna rader justeras vertikalt till den första radens indenteringsnivå. Det kan hjälpa till att göra kod och taggar mer läsbara.

  Dessutom låter det dig att ställa in en maximal bredd av skärmen, som ett procenttal. Därefter justeras inte längre dynamiskt radbrytna rader vertikalt. Vid 50 % får exempelvis inte rader vars indenteringsdjup är mer än 50 % av skärmens bredd någon vertikal justering för efterföljande radbrutna rader.

Kodvikning

- Visa vikmarkörer (om tillgängliga)

- Om det här alternativet är markerat, visar den aktuella vyn markeringar för kodvikning, om kodvikning är tillgänglig.

Kanter

- Visa ikonkant

- Om det här är markerat, ser du en ikonkant till vänster. Ikonkanten visar till exempel bokmärkesmarkeringar.

Visa radnummer

- Om det här är markerat, ser du radnummer till vänster.

Visa rullningslistmarkeringar

- Om det här alternativet är markerat visar aktuell vy markeringar på den vertikala rullningslisten. Markeringarna visar till exempel bokmärken.

Sortera menyn bokmärken

- Enligt position

- Bokmärken ordnas enligt radnumret där de är placerade.

Enligt tillkomst

- Varje nytt bokmärke läggs till längst ner, oberoende av var det är placerat i dokumentet.

Visa indenteringslinjer

- Om det här är markerat, visar editorn vertikala linjer för att hjälpa till att identifiera indenterade rader.

### Teckensnitt och färger

Den här sidan i dialogrutan låter dig ställa in alla teckensnitt och färger i alla färgscheman du har, samt skapa nya scheman eller ta bort befintliga. Varje schema har en inställning av färger, teckensnitt, normal textstil och markeringstextstil.

&kwrite; väljer schemat som för närvarande är aktivt i förväg åt dig. Om du vill arbeta med ett annat schema börja med att välja det i kombinationsrutan Schema.

#### Färger

Textområdets bakgrund

- Normal text

- Det här är förvald bakgrund för redigeringsområdet. Det kommer att vara den dominerande färgen i redigeringsområdet.

Markerad text

- Det här är bakgrunden för markerad text. Förvalt värde är den globala markeringsfärgen, som är inställd i färginställningarna i &kde;.

Aktuell rad

- Ställ in färgen för aktuell rad. Att ställa in den något annorlunda jämfört med den normala textbakgrunden hjälper till att hålla fokus på den aktuella raden.

Bokmärke

- Den här kombinationsrutan låter dig ställa in överlagringsfärger för diverse typer av markeringar. Färgerna blandas in i en markerad rads bakgrundsfärg, så att en aktuell rad med flera markeringar har en bakgrund som är en blandning av flera färger. Markeringsfärgerna används också om du aktiverar visning av markeringar på rullningslisten.

Ytterligare element

- Bakgrund för vänster kant

- Den här färgen används för markeringar, radnummer och vikmarkörkanter till vänster i redigeringsvyn när de visas.

Radnummer

- Den här färgen används för att visa radnummer till vänster i vyn när de visas.

Färglägg parenteser

- Den här färgen används för att markera bakgrunden för matchande parenteser.

Radbrytningsmarkörer

- Den här färgen används för att rita ett mönster till vänster om rader med dynamisk radbrytning när de är vertikalt justerade, samt för statiska radbrytningsmarkörer.

Tabulatormarkörer

- Den här färgen används för att visa indikering av blanktecken när det är aktiverat.

#### Teckensnitt

Här kan du välja teckensnittet för schemat. Du kan välja bland alla teckensnitt som är tillgängliga på systemet, och ställa in förvald storlek. En exempeltext visas längst ner i dialogrutan, så att du kan se effekten av dina val.

#### Normala textstilar

De normala textstilarna ärvs av färgläggningstextstilarna, vilket gör det möjligt för editorn att visa text på ett mycket konsekvent sätt, till exempel använder kommentartext samma stil i nästan alla textformat som Kate kan färglägga.

Namnet i listan med stilar använder stilen som är inställd för objektet, vilket ger en omedelbar förhandsgranskning när en stil ställs in.

Varje stil låter dig välja gemensamma egenskaper samt förgrunds- och bakgrundsfärger. För att inte använda en bakgrundsfärg, högerklicka och använd den sammanhangsberoende menyn.

#### Färgläggningstextstilar

Här kan du redigera textstilarna som används av en viss färgläggningsdefinition. Editorn väljer färgläggningen som används av aktuellt dokument i förväg. För att arbeta med en annan färgläggning, välja en i kombinationsrutan ovanför listan med stilar.

Namnet i listan med stilar använder stilen som är inställd för objektet, vilket ger en omedelbar förhandsgranskning när en stil ställs in.

Varje stil låter dig välja gemensamma egenskaper samt förgrunds- och bakgrundsfärger. För att inte använda en bakgrundsfärg, högerklicka och använd den sammanhangsberoende menyn. Dessutom kan du se om en stil är samma som den förvalda stilen för objektet, och ställa in den till det om den inte är det.

Du märker att många färgläggningar innehåller andra färgläggningar representerade av grupper i stillistan. De flesta färgläggningar importerar till exempel färgläggningen Alerts, och många källkodsformat importerar färgläggningen Doxygen. Redigering av färger i grupperna påverkar bara stilarna när de används i det redigerade färgläggningsformatet.

### Markör och markering

Förflyttning av textmarkör

- Smart home-tangent

- Om markerad, hoppar markören över blanktecken och går till början av radens text när tangenten Home trycks ner.

Flytta markören till nästa rad efter radslut

- När aktiv, och infogningsmarkören flyttas med tangenterna Vänster och Höger går den till föregående eller nästa rad och början eller slutet av raden, på samma sätt som de flesta editorer.

  När inaktiv, kan inte infogningsmarkören flyttas till vänster om radens början, men den kan flyttas förbi radens slut, vilket kan vara mycket praktiskt för programmerare. När alternativet är aktivt, och markören flyttas förbi slutet av en rad (åt höger) med piltangenterna, gör det att den hoppar ner till början av nästa rad. På liknande sätt, om markören flyttas förbi början av en rad (åt vänster) hoppar den upp till slutet av föregående rad. När alternativet är inaktivt, och markören flyttas till höger förbi radens slut gör det bara att den fortsätter horisontellt på samma rad, och ett försök att flytta den åt vänster förbi början av raden gör ingenting.

Page Up och Page Down flyttar markören

- Det här alternativet ändrar beteendet hos markören om användaren trycker på tangenterna Page Up eller Page Down. Om det här inte är valt, behåller textmarkören sin relativa position i den synliga texten i &kwrite; när ny text blir synlig som ett resultat av åtgärden. Så om markören befinner sig mitt i den synliga texten när åtgärden sker kommer den att förbli där (utom när man kommer till början eller slutet). Om det här alternativet är valt, gör den första tangenttryckningen att markören antingen flyttas längst upp eller längst ner när en ny sida med text visas.

Centrera markör automatiskt (rader):

- Anger antalet rader som behålls synliga ovanför och under markören om möjligt.

Markeringsläge

- Normal

- Markeringar skrivs över av inskriven text, och försvinner när markören flyttas.

Långlivat

- Markeringar blir kvar också efter markören flyttas och text skrivs in.

### Redigering

Tabulatorer

- Infoga mellanslag istället för tabulatorer

- När det här är aktiverat, infogar editorn ett beräknat antal mellanslag enligt positionen i texten och inställningen `tab-width` när du trycker på tabulatortangenten.

Visa tabulatorer

- När det här är markerat visar &kwrite; en liten punkt som en synlig representation av tabulatortecken.

  Det gör också att punkter ritas för att ange efterföljande blanktecken. Det kommer att rättas i en framtida version av &kwrite;.

Tabb/indenteringsbredd

- Om alternativet Ersätt tabulator med mellanslag är valt avgör det här värdet antalet mellanslag som editorn använder att automatiskt ersätta tabulatortecken med.

Statisk radbrytning

- Radbrytning är en funktion som orsakar att editorn automatiskt börjar en ny rad med text och flyttar (bryter) markören till början på den nya raden. &kwrite; startar automatiskt en ny rad med text när den nuvarande raden når längden som anges av alternativet Bryt rader vid:.

  Aktivera statisk radbrytning

- Sätter på eller stänger av dynamisk radbrytning.

Visa statisk radbrytningsmarkör (om tillämplig)

- Om det här alternativet är markerat, ritas en vertikal linje i radbrytningskolumnen som definieras i Inställningar Anpassa editor... under fliken Redigering. Observera att radbrytningsmarkören bara ritas om du använder ett teckensnitt med fast breddsteg.

Bryt rader vid:

- Om alternativet Radbrytning är valt avgör det här värdet längden (i tecken) där editorn automatiskt påbörjar en ny rad.

Ta bort mellanslag i slutet av en rad

- &kwrite; tar automatiskt bort extra mellanslag i slutet på textrader.

Automatiska hakparenteser

- När användaren skriver en vänsterparentes ([, (, eller {) skriver &kwrite; automatiskt in högerparentesen (}, ), eller ]) till höger om markören.

Maximalt antal ångra-steg:

- Här kan användaren ange antal steg som &kwrite; behåller i minnet för att kunna ångra inmatning och åtgärder. Det här betyder att ju högre antalet steg ställs in desto mer minne kommer &kwrite; att använda till det här. Om det här ställs in till 10, betyder det att användaren kan ångra de tio senaste åtgärderna, dvs., klicka på knappen ångra 10 gånger och få resultat.

Smart sökning av text från:

- Det här avgör var &kwrite; hämtar söktexten (den skrivs automatiskt in i dialogrutan Sök text):

  - Ingenstans: Gissa inte söktexten.

  - Bara markering: Använd aktuell markering om tillgänglig.

  - Markering, därefter aktuellt ord: Använd aktuell markering om tillgänglig, använd annars aktuellt ord.

  - Bara aktuellt ord: Använd ordet som markören för närvarande finns i, om tillgängligt.

  - Aktuellt ord, därefter markering: Använd aktuellt ord om tillgängligt, använd annars aktuell markering.

  Observera att för alla ovanstående alternativ, om en söksträng inte har eller kan bestämmas, återgår dialogrutan Sök text till den senaste söktexten.

### Indentering

Automatisk indentering

- Indenteringsläge:

- Välj automatiskt indenteringsläge som du normalt vill använda. Du rekommenderas starkt att använda `Inget` eller `Normal` här, och använda inställning av filtyper för att ställa in andra indenteringslägen för textformat som C/C++ kod eller &XML;.

Infoga inledande Doxygen "*" vid inskrivning

- Infoga automatiskt ett inledande "*" när text skrivs in inne i en kommentar med Doxygen-stil. Inställningen aktiveras bara när den är tillämplig.

Indentering med mellanslag

- Använd mellanslag istället för tabulator för indentering

- Det här ersätter tabulatortecken med det antal mellanslag som ställs in med Antal mellanslag: nedan.

Emacs-liknande blandat läge

- Använd en blandning av tabulatortecken och mellanslag för indentering.

Antal mellanrum:

- Ställ in det antal mellanslag du vill använda för indentering när du markerar Använd mellanslag istället för tabulator för att indentera ovan.

Behåll indenteringsprofil

- När det här är markerat, avindenterar inte editorn rader ytterligare i en markering när raden med minst indentering blir avindenterad. Om du ibland avindenterar block med indenterad kod, kan det vara till hjälp.

Behåll extra mellanslag

- Indentering med mer än det valda antalet mellanslag kommer inte att förkortas.

Tangenter att använda

- Tabulatortangent indenterar

- Det här gör att tangenten tab kan användas för att indentera.

Backsteg indenterar

- Det här gör att tangenten backsteg kan användas för att indentera.

Tabulatortangentläge om ingenting markerat

- Infoga indenteringstecken

- Det här låter tabulatortangenten infoga indenteringstecken.

Infoga tabulatortecken

- Det här låter tabulatortangenten infoga ett tabulatortecken.

Indentera aktuell rad

- Det här låter tabulatortangenten indentera aktuell rad.

### Öppna/Spara

Filformat

- Kodning:

- Det här ställer in förvald teckenkodning för dina filer.

Radslut:

- Välj radslutsläget du föredrar för det aktiva dokumentet. Du kan välja bland &UNIX;, DOS/&Windows; eller MacIntosh.

Automatisk detektering av radslut

- Markera det här om du vill att editorn automatiskt ska detektera radslutstyp. Den första radslutstypen som hittas används för hela filen.

Minnesanvändning

- Maximalt antal laddade block per fil:

- Editorn laddar angivet antal textblock (med omkring 2048 rader) i minnet. Om filstorleken är större än så, växlas andra block ut till disk och laddas transparent efter behov.

  Det kan orsaka små fördröjningar vid navigering i dokumentet. Ett större antal block ökar redigeringshastigheten på bekostnad av minne.

  Välj bara det största möjliga antal block för normal användning: begränsa det bara om du har problem med minnesanvändning.

Automatisk rensning vid ladda eller spara

- Ta bort mellanslag i slutet av en rad

- Editorn tar automatiskt bort extra mellanslag i slutet av textrader när filen laddas eller sparas.

Kataloginställningsfil

- Sökdjup för inställningsfil:

- Editorn söker det angivna antalet katalognivåer uppåt efter en &kwrite; inställningsfil och laddar inställningsraden från den.

Spara säkerhetskopia

- Säkerhetskopiering när du sparar gör att &kwrite; kopierar filen på disk till <prefix><filnamn><suffix> innan ändringarna sparas. Suffixet har normalvärdet ~ och prefixet är normalt tomt.

  Lokala filer

- Markera det här om du vill ha säkerhetskopior av lokala filer när du sparar.

Fjärrfiler

- Markera det här om du vill ha säkerhetskopior av fjärrfiler när du sparar.

Prefix

- Skriv in prefixet som ska läggas till i början av den säkerhetskopierade filens namn.

Suffix

- Skriv in suffixet som ska läggas till sist i den säkerhetskopierade filens namn.

### Färgläggning

Den här gruppen av alternativ används för att anpassa färgläggningsstilarna för varje typ av programmeringsspråk. Alla ändringar du gör i andra områden av dialogrutan gäller bara denna typ.

Färglägg:

- Det här används för att välja språktyp att ställa in.

Information

- Visa egenskaper för syntaxfärgläggningsregler för det valda språket: upphovsmannens namn och licens.

Egenskaper

- Filändelser:

- Det här är listan med filändelser som används för att avgöra vilka filer som ska färgläggas med det nuvarande syntaxfärgläggningsläget.

Mime-typer:

- Att klicka på guideknappen visar en dialogruta med en lista över alla tillgängliga Mime-typer att välja bland.

  Posten Filändelser redigeras också automatiskt.

Prioritet:

- Ställ in prioritet för färgläggningsregeln.

Ladda ner...

- Klicka på knappen för att ladda ner nya eller uppdaterade syntaxfärgläggningsbeskrivningar från &kate;s webbplats.

### Filtyper

Den här sidan låter dig överskrida förvalda inställningar för dokument med angivna Mime-typer. När editorn laddar ett dokument, kontrollerar den om det matchar filmasken eller Mime-typerna för en av de definierade filtyperna, och om det är fallet tillämpas variablerna som är definierade. Om mer än en filtyp matchas, används den med högst prioritet.

Filtyp:

- Filtypen med högst prioritet är den som visas först i kombinationsrutan. Om fler filtyper hittas, anges de också.

  Ny

- Det här används för att skapa en ny filtyp. Efter du klickat på knappen, blir fälten nedanför tomma och du kan fylla i de egenskaper du vill ha för den nya filtypen.

Ta bort

- För att ta bort en befintlig filtyp, markera den i kombinationsrutan och tryck på knappen Ta bort.

Egenskaper för aktuell filtyp

- Filtypen med högst prioritet är den som visas först i kombinationsrutan. Om fler filtyper hittas, anges de också.

  Namn:

- Filtypens namn är texten i motsvarande menyalternativ. Namnet visas i menyn Verktyg Filtyp.

Sektion:

- Sektionsnamnet används för att organisera filtyper i menyer. Det används också i menyn Verktyg Filtyp.

Variabler:

- Strängen låter dig ställa in &kwrite;s inställningar för filer som väljes av den här Mime-typen genom att använda variabler i &kwrite;. Du kan ställa in nästan alla inställningsalternativ, såsom färgläggning, indenteringsläge, kodning, etc.

  För en fullständig lista med kända variabler, se handboken.

Filändelser:

- Jokerteckenmasken låter dig välja filer enligt filnamn. En typisk mask använder en asterisk och filändelsen, till exempel `*.txt; *.text`. Strängen är en lista med masker åtskilda av semikolon.

Mime-typer:

- Visar en guide som hjälper dig att enkelt välja Mime-typer

Prioritet:

- Anger en prioritet för filtypen. Om fler filtyper väljer samma fil, används den med högst prioritet.

### Genvägar

Här kan du ändra inställningen av snabbtangenter. Välj en åtgärd och klicka på Egen om du vill ha en annan snabbtangent för åtgärden.

Sökraden låter dig leta efter en specifik åtgärd och se dess motsvarande snabbtangent.

### Insticksprogram

Den här fliken visar alla tillgängliga insticksprogram, och du kan markera de du vill använda. När ett insticksprogram väl är markerat, aktiveras knappen Anpassa och du kan klicka på den för att anpassa det markerade insticksprogrammet.

## Tack till och licenser

&kwrite; Copyright 2001 av &kate;-gruppen.

Baserad på den ursprungliga &kwrite;, som var copyright 2000 av Jochen Wilhelmy digisnap@cs.tu-berlin.de

Bidragsgivare:

- &Christoph.Cullmann; &Christoph.Cullmann.mail;

- Michael Bartl michael.bartl1@chello.at

- Phlip phlip_cpp@my-deja.com

- &Anders.Lund; &Anders.Lund.mail;

- Matt Newell newellm@proaxis.com

- &Joseph.Wenninger; &Joseph.Wenninger.mail;

- Jochen Wilhely digisnap@cs.tu-berlin.de

- &Michael.Koch; &Michael.Koch.mail;

- &Christian.Gebauer; &Christian.Gebauer.mail;

- &Simon.Hausmann; &Simon.Hausmann.mail;

- Glen Parker glenebob@nwlink.com

- Scott Manson sdmanson@altel.net

- &John.Firebaugh; &John.Firebaugh.mail;

Originaldokumentation av &Thad.McGinnis; &Thad.McGinnis.mail;

Uppdaterad av &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; och &Anders.Lund; &Anders.Lund.mail;

Den här versionen av &kwrite;s handbok är baserad på originalet av &Cristian.Tibirna; &Cristian.Tibirna.mail;

Ändrad till docbook/granskning av &Lauri.Watts; &Lauri.Watts.mail;

Översättning Stefan Asserhäll stefan.asserhall@comhem.se

&underFDL; &underGPL;
&documentation.index;