# Grundläggande beskrivning

Har du använt en texteditor tidigare kommer du inte få några problem med &kate;. I nästa två avsnitt, Starta &kate; och Arbeta med &kate; kommer vi visa dig allt du behöver för att snabbt komma igång.

## Starta &kate;

Du kan starta &kate; från K-menyn eller från kommandoraden.

### Från menyn

Öppna &kde;:s programmeny genom att klicka på den stora K-ikonen på verkgtygsraden längst ner till vänster på skärmen. Då dyker en meny upp. Flytta pekaren uppåt i menyn till menyalternativet Program Verktyg Avancerad texteditor &kate;.

### Från kommandoraden

Du kan starta &kate; genom att skriva dess namn på kommandoraden. Om du anger ett filnamn, som i exemplet nedan, kommer det att öppna eller skapa den här filen.

    %kate minfil.txt

Om du har en aktiv anslutning och behörigheter, kan du dra fördel av &kde;:s nätverkstransparens för att öppna filer på Internet.

    %kate ftp://ftp.kde.org/pub/kde/README

#### Kommandoradsväljare

&kate; godtar följande argument på kommandoraden:

``kate` `--help``

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

``kate` `--help-qt``

- Visar argumenten tillgängliga för att ändra hur &kate; samarbetar med &Qt;.

``kate` `--help-kde``

- Visar argumenten tillgängliga för att ändra hur &kate; samarbetar med &kde;.

``kate` `-s` `--start` `namn``

- Startar Kate med sessionen `namn`. Sessionen skapas om den inte redan finns. Om en instans av &kate; som kör den angivna sessionen finns, laddas angivna filer i den instansen. När det används med väljaren `--use`, används också en instans som kör den här sessionen.

``kate` `-u` `--use` `webbadress``

- Gör att &kate; använder en befintlig instans om någon finns. Det är nu det normala beteendet, men alternativet finns kvar av kompatibilitetsskäl.

``kate` `-p` `--pid` `processidentifierare``

- Återanvänder bara en instans med den angivna processidentifikationen (PID). Används med väljaren `--use`.

``kate` `-e` `--encoding` `kodning` `webbadress``

- Använder angiven kodning för dokumentet.

``kate` `-l` `--line` `rad` `webbadress``

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

``kate` `-c` `--column` `kolumn` `webbadress``

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

``kate` `-i` `--stdin``

- 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 &kate; via en rörledning.

``kate` `--startanon``

- Starta &kate; med en ny anonym session, medför `-n`.

``kate` `-n` `--new``

- Tvinga att en ny instans av &kate; startas (ignoreras om `start` används och en annan instans av &kate; redan har den angivna sessionen öppen), tvingad om inga parametrar och inga webbadresser alls anges.

``kate` `-b` `--block``

- Om en instans av &kate; som redan kör används, blockera till den avslutas, om webbadresser är angivna att öppnas.

  Med det här alternativet kan &kate; användas för att skriva in incheckningsmeddelanden för versionskontrollsystem som Git eller Subversion. Sådana system förväntar sig att de kan blockera editorn till meddelandet har matats in, eftersom de därefter öppnar en tillfällig fil, som skulle vara tom om Kate omedelbart returnerade till den som anropar.

  Alternativet behövs också med KIO (&kde;:s indata och utdata), om en fjärrfil öppnas (som laddats ner till en tillfällig fil) och ska laddas upp igen, efter att den har sparats.

``kate` `--tempfile``

- Från &kate; 2.5.1 stöds den här standardväljaren i &kde;. När den används, behandlas angivna filer som tillfälliga filer och tas bort (om de är lokala filer och du har tillräckliga rättigheter) när de stängs, om de inte har ändrats sedan de öppnades.

``kate` `--help-all``

- Visar alla kommandoradsväljare.

``kate` `--author``

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

``kate` `-v` `--version``

- Anger versionsinformation för &Qt;, &kde; och &kate;.

``kate` `--license``

- Visar licensinformation.

### Drag och släpp

&kate; använder &kde;s drag och släpp protokoll. Filer kan dras och släppas på &kate; från skrivbordet, filhanteraren &dolphin; eller någon FTP-fjärrplats öppnad i ett av &dolphin;s fönster.

## Arbeta med &kate;

Snabbstart visar dig hur enkelt du kan göra inställningar med fyra enkla alternativ ställa in flera kraftfulla specialiteter i &kate;. Snabbtangenter visar några förvalda snabbtangentgenvägar för de som inte kan eller vill använda musen.

### Snabbstart

Det här avsnittet beskriver några av alternativen på menyn Visa så att du snabbt kan få &kate; att fungera som du vill.

När du startar &kate; för första gången, kommer du att se två fönster med vit bakgrund. Över de två fönstren finns en verktygsrad med de vanliga ikonerna. Och ovanför den, en menyrad.

Fönstret till vänster är en dockningsbar sidorad. Det kombinerar Dokument och Filsystembläddraren. Byt mellan de två genom att klicka på flikarna till vänster om fönstret.

Om du har startat &kate; med en fil, kommer fönstret till höger att visa filen du redigerar och Dokument i sidoraden kommer att visa filens namn. Använd fönstret Filsystembläddraren för att öppna filer.

Du kan visa eller dölja dokumentfönstret och filsystembläddraren i menyn Visa Verktygsvyer. Menyn ger dig ditt första intryck av hur kraftfullt och anpassningsbart &kate; är. I det här avsnittet tittar vi på tre alternativ:

Visa dokument

- Sätter på eller stänger av visning av dokumenten.

### Genvägar

Många av snabbtangenterna i &kate; är konfigurerbara i menyn Inställningar. Vanligtvis har &kate; följande snabbtangenter.

Infoga | Skiftar mellan lägena Infoga och Skriv över. I läget Infoga kommer editorn att infoga skrivna tecken i texten och skjuta tidigare inskriven data åt höger om textmarkören. Läget Skriv över gör att varje tecken som skrivs in eliminerar det nuvarande tecknet.
Vänsterpil | Flyttar markören ett tecken till vänster
Högerpil | Flyttar markören ett tecken till höger
Uppåtpil | Flyttar markören en rad upp
Neråtpil | Flyttar markören en rad ner
Page Up | Flyttar markören upp en sida
Page Down | Flyttar markören ned en sida
Backsteg | Raderar tecknet till vänster om markören
Hem | Flyttar markören till början av raden
End | Flyttar markören till slutet på raden
Ta bort | Ta bort tecknet till höger om markören (eller eventuellt vald text)
&Shift;Retur | Infoga nyrad inklusive inledande tecken på nuvarande rad som inte är bokstäver eller siffror. Det är t.ex. användbart för att skriva kommentarer i koden: I slutet av raden // någon text tryck på snabbtangenten så börjar den nästa raden redan med //. Du behöver alltså inte skriva in kommentartecknen i början av varje ny rad med kommentarer.
&Shift; vänsterpil | Markerar ett tecken till vänster
&Shift; högerpil | Markerar ett tecken till höger
F1 | Hjälp
&Shift; F1 | Vad är det här?
&Ctrl;F | Sök
F3 | Sök igen
&Ctrl;B | Skapar ett Bokmärke
&Ctrl;C | Kopiera den markerade texten till klippbordet
&Ctrl;N | Nytt dokument
&Ctrl;P | Skriv ut
&Ctrl;Q | Avslutar - Stänger aktuell editor
&Ctrl;R | Ersätt
&Ctrl;S | Spara filen
&Ctrl;V | Klistra in
&Ctrl;X | Radera markerad text och kopierar den till klippbordet
&Ctrl;Z | Ångra
&Ctrl;Skift Z | Gör om

## Arbeta med &kate;s multipla dokumentgränssnitt

### Översikt

Fönster, vy, dokument, ram, editor... Vad betyder de allihop i &kate;s terminologi, och hur får man ut så mycket som möjligt av dem? Det här kapitlet förklarar allt detta, och lite till.

#### Huvudfönstret

Huvudfönstret i &kate; är ett &kde; standardprogramfönster, med tillägg av sidorader som innehåller verktygsvyer. Det har en menyrad med alla de vanliga menyerna, och några till, och en verktygsrad som ger tillgång till ofta använda kommandon.

Den viktigaste delen av fönstret är redigeringsområdet, som normalt visar en enda texteditorkomponent, där du kan arbeta med dokument.

Dockningsmöjligheterna i fönstret används för verktygsfönster:

- Dokumentlistan

- Filsystembläddraren

- Den inbyggda terminalen

Och möjligen andra verktygsfönster, som till exempel tillhandahålls av insticksprogram.

Verktygsvyer kan placeras i vilken sidorad som helst. För att flytta ett verktyg, högerklicka på dess sidoradsknapp och välj i menyn.

En verktygsvy kan markeras som permanent i sidoradens meny som visas med höger musknapp. Sidoraden kan innnehålla flera verktyg på en gång, så att när ett verktyg är permanent kan andra verktyg visas samtidigt.

### Redigeringsområdet

&kate; klarar av att ha mer än ett dokument öppet på samma gång, och också att dela redigeringsområdet i hur många rutor som helst, vilket fungerar på ett liknande sätt som till exempel &konqueror; eller den populära texteditorn emacs. På det här sättet kan du titta på flera dokument samtidigt, eller flera instanser av samma dokument, vilket är praktiskt om ditt dokument till exempel innehåller definitioner längst upp som du ofta vill referera till. Eller du skulle kunna titta på en deklarationsfil för ett program i en ruta, medan du redigerar implementeringsfilen i en annan.

När ett dokument är tillgängligt i mer än en editor, så visas omedelbart ändringar i en editor också i de andra. Det här omfattar ändringar i texten, samt markering av texten. Sökoperationer eller förflyttning av markören visas bara i den nuvarande editorn.

Det är för närvarande inte möjligt att ha flera instanser av samma dokument öppna, på det sättet att en instans redigeras medan den andra inte gör det.

När editorn delas i två delar, delas den upp i två lika stora rutor, som båda visar det nuvarande dokumentet i editorn. Den nya rutan är längst ner (i fallet med en horisontell delning) eller till höger (för en vertikal delning). Den nya rutan får fokus, vilket visas med en liten grön punkt i rutan som har fokus.

### Dokumentlistan

Dokumentlistan visar en lista med alla dokument som för närvarande är öppna i &kate;. Ändrade filer har en liten diskettikon till vänster för att ange detta tillstånd.

Normalt visas dokumentlistan med Trädläge, som visar katalogstrukturen som omger alla för närvarande öppna dokument. Listläge är också tillgängligt, som visar en enkel lista med alla öppna dokument. Du kan byta läge genom att högerklicka på listan och välja i menyn Visningsläge.

Om två eller flera filer med samma namn (som finns i olika kataloger) är öppna i Listläge, så läggs (2) till sist i namnet, och så vidare. Verktygstipset för filen visar hela namnet, inklusive sökvägen, och låter dig därmed välja den önskade filen.

För att visa ett dokument i fönstret som för närvarande är aktivt, klicka på dokumentnamnet i listan.

Du kan sortera listan på några olika sätt genom att högerklicka i den och välja i menyn Sortera enligt. Alternativen är:

Öppningsordning

- Listar dokumenten i ordningen de öppnats.

Dokumentnamn

- Listar dokumenten alfabetiskt enligt namn.

Dokumentsökväg

- Listar dokumenten alfabetiskt enligt deras sökväg.

Dokumentlistan visar normalt historiken genom att skugga posterna för de senaste dokumenten med en bakgrundsfärg. Om dokumentet har redigerats, tonas extra färg in. Det senaste dokumentet har starkast färg, så att du lätt hittar dokumenten du arbetar med. Funktionen kan stängas av på sidan Dokument i inställningsdialogrutan.

Den normala platsen för dokumentlistan i &kate;s fönster är till vänster om redigeringsområdet.

## Använda sessioner

Sessioner är sättet som &kate; använder för att låta dig hantera mer än en lista med filer och inställning av det grafiska gränssnittet. Du kan ha hur många namngivna sessioner som du vill, och du kan använda namnlösa eller anonyma sessioner för filer som du bara vill använda en gång. För närvarande kan &kate; spara listan med öppna filer, och den allmänna fönsterinställningen i sessionen. Framtida versioner av &kate; kan komma att lägga till fler funktioner som kan sparas i sessioner. Med introduktionen av sessioner låter &kate; dig också öppna hur många instanser av programmet som helst, istället för bara en som tidigare var det normala beteendet.

Sessioner stöds i tre områden:

- Kommandoradsväljare som låter dig välja och starta sessioner när du startar Kate från kommandoraden.

- Menyn Sessioner som låter dig byta, spara, starta och hantera dina sessioner.

- Inställningsalternativ som låter dig bestämma hur sessioner i allmänhet ska bete sig.

När en ny session startas, laddas inställningen för det grafiska användargränssnittet Förvald session. För att spara fönsterinställningen i den förvalda sessionen, måste du aktivera att fönsterinställningar sparas på inställningssidan för sessioner i inställningsdialogrutan, och därefter ladda förvald session, ställa in fönstret som önskas, och spara sessionen igen.

När en namngiven session laddas, visar &kate; sessionsnamnet i början av fönstrets namnlist, som då har formen "`Sessionsnamn`: `Dokumentnamn eller webbadress` - &kate;"

När filer öppnas från kommandoraden med `--start `namn`` eller om en session väljes med sessionsväljaren, laddas den angivna sessionen innan filerna som anges på kommandoraden. För att öppna filer från kommandoraden med en ny, namnlös session, ställ in Kate att normalt starta en ny session på inställningsdialogrutans sessionssida, eller använd `--start` med en tom sträng: `''`.

Från &kate; 2.5.1 exporteras processidentifikationen (PID) för den aktuella instansen till miljövariabeln `KATE_PID`. När filer öppnas från den inbyggda terminalen väljer Kate automatiskt den aktuella instansen om ingenting annat anges på kommandoraden.

### Återställa gammaldags beteende hos &kate;

När du vant dig vid att använda sessioner, kommer du förhoppningsvis att märka att de tillhandahåller ett mycket enkelt och effektivt verktyg för att arbeta i olika områden. Om du dock föredrar det gamla beteendet hos &kate; (där en instans öppnar alla filer), kan du enkelt åstadkomma det genom att följa följande enkla strategi:

- Få Kate att alltid starta med väljaren `--use` genom att lägga till den i kommandot i programinställningarna, och dessutom använda ett skalalias.

- Anpassa &kate; att ladda den senast använda sessionen vid start.

- Anpassa &kate; att spara fillistan när en session stängs.

- Ladda den förvalda sessionen en gång.

## Hämta hjälp

### Med &kate;

Den här handboken

- Erbjuder detaljerad dokumentation av alla menykommandon, inställningsalternativ, verktyg, dialogrutor, insticksprogram etc., samt beskrivningar av &kate;s fönster, editorn och diverse koncept som används av programmet.

  Tryck på F1 eller använd menyalternativet Hjälp Handbok &kate; för att titta i den här handboken.

Vad är det här hjälp

- Vad är det här hjälp erbjuder omedelbar hjälp med enstaka element i grafiska fönster, som knappar och andra områden i fönster.

  Vi försöker tillhandahålla Vad är det här hjälp för alla element som det är vettigt. Det är tillgängligt genom hela inställningsdialogrutan, samt i många andra dialogrutor.

  För att använda Vad är det här hjälp, tryck på &Shift; F1 eller använd menyalternativet Hjälp Vad är det här för att aktivera Vad är det här läget. Markören ändras till en pil med ett frågetecken, och du kan nu klicka på vilket element som helst i fönstret för att läsa Vad är det här hjälpen för elementet, om den finns tillgänglig.

Hjälpknappar i dialogrutor

- Vissa dialogrutor har en Hjälp-knapp. Genom att trycka på den startas Hjälpcentralen, och öppnar motsvarande dokumentation.

### Med dina textfiler

&kate; tillhandahåller inte (ännu!) något sätt att läsa dokumentrelaterad dokumentation. Beroende på filen som du redigera, kan du märka att den inbyggda terminalen är användbar för att visa relaterade &UNIX; manualsidor, eller info-dokumentation, eller också så kan du använda &konqueror;.

### Artiklar om &kate;

&kate;s hemsida tillhandahåller några artiklar och handledningar med ytterligare information utanför den här handbokens omfattning.