# 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 Starta program eller från kommandoraden.

### Från menyn

Öppna &kde;:s programmeny genom att klicka på ikonen för Starta program 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 &kde-ftp;README

För att ändra katalog för tillfälliga filer, som normalt är `/tmp` ställ in miljövariabeln `TMPDIR` innan &kate; startas, t.ex.

    %mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

#### Kommandoradsväljare

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

``kate` `--help``

- Visar väljarna som är tillgängliga från kommandoraden.

``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.

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

- Återanvänder bara en instans med den angivna processidentifikationen (PID).

``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``

- 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` `--desktopfile` `filnamn``

- Basfilnamnet på skrivbordsposten för programmet.

  Det är särskilt användbart för omgivande program och program som i allmänhet har flera skrivbordsfiler. På så sätt kan varje skrivbordsfil ha sin egen kommandorad i posten `Exec`.

``kate` `--author``

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

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

- Anger versionsinformation för &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 alla sidoradsfönster i menyn Visa Verktygsvyer eller använda &Ctrl;&Alt;&Shift;F. Menyn ger dig ditt första intryck av hur kraftfullt och anpassningsbart &kate; är.

Under Verktygsvyer finns en lista över alla aktiverade insticksprogram. Klicka på kryssrutan framför varje alternativ, eller klicka med vänster musknapp på verktygsknapparna i sidoraden för att sätta på eller stänga av verktygsvyn.

### Genvägar

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

F1 | Hjälp
&Shift; F1 | Vad är det här?
&Ctrl;N | Nytt dokument
&Ctrl;L | Spara alla
&Ctrl;O | Öppna ett dokument
&Ctrl;&Alt;O | Snabböppna
&Ctrl;&Shift;F | Fullskärmsläge
&Ctrl;&Shift;, | Anpassa &kate;
&Ctrl;W / &Ctrl;&Esc; | Stäng
&Ctrl;Q | Avslutar - Stänger aktuell editor
&Ctrl;&Alt;&Shift;F | Visa sidorader
&Ctrl;&Shift;T | Dela horisontellt
&Ctrl;&Shift;L | Dela vertikalt
F8 | Nästa delade vy
&Shift;F8 / &Ctrl;&Esc; | Föregående delade vy
&Ctrl;&Shift;R | Stäng aktuell vy
&Alt;Högerpil | Nästa flik
&Alt;Vänsterpil | Föregående flik

Dessutom kan genvägarna som tillhandahålls av komponenten &katepart; och av alla aktiverade &kate; insticksprogram.

## 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.

Fönstrets dockningsmöjligheter används för verktygsfönster för alla insticksprogram som är aktiverade i inställningsdialogrutan.

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.

Om ett insticksprogram har inställningsalternativ kan det första alternativet i den sammanhangsberoende menyn användas för att visa motsvarande sida i &kate;s inställningsdialogruta.

### 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.

## 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.

## Snabböppna

För att snabbt kunna öppna eller byta mellan filer, levereras Kate med en inbyggd snabböppningsdialogruta. Du kan öppna den med &Ctrl;&Alt;O.

Snabböppna kan visa alla öppna dokument i Kate samt alla filer i öppna projekt. För att kunna se alla projektfiler måste du aktivera Projektinsticksprogram.

### Använda Snabböppna

Det är mycket enkelt att använda snabböppna. När det väl är öppnat, skriv in namnet eller en del av namnet på filen som du vill öppna så filtrerar snabböppna listan baserat på vad du skrev in. Tryck på returtangenten för att öppna den markerade filen, eller &Esc; för att dölja snabböppna.

Normalt matchas bara filnamnet vid filtrering. Om du vill matcha sökvägen, måste "/" ingå i texten. Exempelvis matchar "doc/index" alla filer som innehåller "index" inne i katalogen "doc".

Dokumenten som redan är öppna är markerade med fetstil och listas längst upp när dialogrutan öppnas. Dessutom är det föregående öppnade dokumentet redan markerat, så att du bara kan trycka på returtangenten så kommer du till det dokumentet.

### Anpassa Snabböppna

Snabböppna

Snabböppna tillhandahåller några inställningsalternativ. Högerklicka på inmatningsraden för att komma åt alternativen.

För närvarande tillgängliga alternativ är:

- `Aktuellt projekt`: Visa bara filer från det aktuella projektet

  `Alla projekt`: Visa filer från alla öppna projekt

  `Inexakt filtrering`: Använd en inexakt matchningsalgoritm för att filtrera filer

  `Filtrering med jokertecken`: Använd filtrering med jokertecken

## 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.