&Anders.Lund; &Anders.Lund.mail;
Johan
Thelmén

    jth@home.se

Översättare

# Anpassa &kate;

## Översikt

&kate; erbjuder flera sätt att justera programmet så att det beter sig som önskas. De viktigaste är:

Inställningsdialogrutan

  Det huvudsakliga inställningsverktyget, som låter dig anpassa programmet &kate;, editorkomponenten och användning av insticksprogram.

Menyn Inställningar

  Låter dig ändra ofta använda inställningar, och att starta inställningsdialogrutor.

Menyn Visa

  Låter dig dela det nuvarande fönstret, samt visa ikoner och radnummer för dokumentet som redigeras för närvarande.

Den inbyggda terminalen använder inställningarna som definieras i systeminställningarna, och kan anpassas genom att klicka med höger musknapp för att visa en sammanhangsberoende meny.

## Den huvudsakliga inställningsdialogrutan

Inställningsdialogrutan för &kate; visar ett träd med grupper till vänster, och en inställningssida som motsvarar den valda gruppen till höger.

Inställningarna är uppdelade i två grupper, närmare bestämt

- Inställning av programmet

- Inställning av editorkomponenten

## Inställning av programmet &kate;

Den här gruppen innehåller sidor för att anpassa det huvudsakliga &kate;-programmet.

### Allmänt

Den här sidan innehåller ett fåtal globala alternativ för &kate;.

Uppträdande
  Varna om filer ändras av främmande processer

    När aktiverad, underrättar &kate; dig om filer som ändrats utanför programmet så fort huvudfönstret får inmatningsfokus. Du kommer att kunna hantera flera ändrade filer samtidigt. Du kan ladda om, spara eller kasta ändrade filer i grupper.

    Om inte aktiverad, frågar &kate; dig om en åtgärd när en externt ändrad fil får fokus inne i programmet.

Metainformation
  Behåll metainformation mellan sessioner

    När aktiverad, lagrar &kate; metadata som bokmärken och sessionsinställningar också när du stänger dokument. Data används om dokumentet är oförändrat när det öppnas igen.

  Ta bort oanvänd metainformation efter

    Ställ in maximalt antal dagar som metainformation behålls för oöppnade filer. Det hjälper till att hålla databasen med metainformation på en rimlig storlek.

### Sessioner

Den här sidan innehåller alternativ som hör ihop med att använda sessioner.

Delar av sessioner
  Inkludera fönsterinställningar

    Om aktiverad, sparar &kate; fönsterinställningen med varje session.

Beteende vid programstart

  Välj hur du vill att &kate; ska bete sig vid start. Inställningen kan överskridas genom att ange vad som ska göras på kommandoraden.

  Starta ny session

    Med det här alternativet startar &kate; en ny namnlös session när det startas.

  Ladda senast använda session

    &kate; använder den senast öppnade sessionen vid start. Det är bra om du alltid vill använda samma session, eller sällan byta.

  Välj en session manuellt

    &kate; visar en liten dialogruta som låter dig välja sessionen du föredrar, eller ladda standardsessionen om ingen har sparats. Det är förvalt beteende. Bra om du ofta använder många olika sessioner.

Ändringar av sessionens information (öppnade filer, och om aktiverat, fönsterinställning) sparas alltid.Om aktiverad, sparar &kate; fönsterinställningen med varje session.

### Insticksprogram

Den här sidan tillhandahåller en lista med installerade insticksprogram för programmet &kate;. Varje insticksprogram representeras med namn och en kort beskrivning. Du kan markera kryssrutan vid ett objekt för att aktivera insticksprogrammet det representerar.

Om ett insticksprogram tillhandahåller inställningsalternativ, visas en sida för att komma åt dem som en underliggande sida till denna.

För mer information om de tillgängliga insticksprogrammen, se .

### Dokument

Bakgrundsskuggning

  Den här sidan låter dig aktivera eller inaktivera skuggning av bakgrunden som åskådliggör din senaste aktivitet, och välja vilka färger som används om den är aktiverad. Se avsnittet om dokumentlistan för mer om funktionen.

Sortera i

  Ställ in hur du vill att dokumentlistan ska sorteras. Det kan också ställas in från menyn som visas med höger musknapp i dokumentlistan.

Visa fullständig sökväg

  Om aktiverat visas toppnivåkataloger i trädläge med fullständig sökväg istället för bara det sista katalognamnet.

Visningsläge

  Det här tillhandahåller två alternativ som påverkar visningen i verktygsvyn Dokument. Alternativet Trädvy visar dokumenten i ett träd under katalogerna de befinner sig i, medan Listvy visar en enkelt lista med dokument.

Visa fullständig sökväg

  När trädvyn och detta alternativ är aktiverat, visas den fullständiga sökvägen i filsystemet till katalogen för de katalogposter som visas i verktygsvyn Dokument, förutom själva katalogens namn. Det har ingen effekt i listvyn.

### Terminal

Sidan visas bara av vyinsticksprogrammet Terminalverktyg, som normalt är aktiverat.

Synkronisera automatiskt terminalen med aktuellt dokument om möjligt

  Det gör att den inbyggda terminalen att byta katalog med `cd` till katalogen för det aktiva dokumentet, när den startas, och när ett nytt dokument får fokus. Om det inte aktiveras, måste du flytta dig i terminalen själv.

Ställ in miljövariabeln EDITOR till 'kate -b'

  Detta ställer in miljövariabeln `EDITOR` så att program som kör i den inbyggda terminalen som automatiskt öppnar en fil i editorn, öppnar dem i &kate; istället för standardeditorn som är inställd i skalet. Du kommer inte att kunna fortsätta använda terminalen innan du har stängt filen i &kate;, så att det anropande programmet är medvetet om att du är klar med redigeringen av filen.

&configuring-part-sections;

## Anpassa med dokumentvariabler

Variabler i &kappname; är Kate-programdelens implementering av dokumentvariabler, som liknar modelines i Emacs och Vi. I Kate-programdelen har raderna följande format: `kate: VARIABELNAMN VÄRDE; [ VARIABELNAMN VÄRDE; ... ]`. Raderna kan förstås finnas i en kommentar, om filen har ett format med kommentarer. Variabelnamn är enstaka ord (inga blanktecken), och allt fram till nästa semikolon är värdet. Semikolonet är nödvändigt.

Här är ett exempel på en variabelrad, som styr indenteringsinställningar för en C++, Java eller Javaskript-fil:

    // kate: replace-tabs on; indent-width 4; indent-mode cstyle;

Bara de första och sista 10 raderna söks igenom efter variabelrader.

Dessutom kan dokumentvariabler placeras i en fil som heter `.kateconfig` i vilken katalog som helst, och de angivna inställningarna verkställs som om modelines skrivits in i varje fil i katalogen och i dess underkataloger, så långt ner som det inställda sökdjupet. Dokumentvariabler i `.kateconfig` använder samma syntax som modelines.

Det finns variabler som stöder nästan alla inställningar i Kate-programdelen, och ytterligare insticksprogram kan använda variabler, som i så fall ska vara dokumenterade i insticksprogrammets dokumentation.

### Hur &kappname; använder variabler

När inställningarna läses, letar Kate-programdelen på följande ställen (i denna ordning):

- Den allmänna inställningen.

- Valfri sessionsdata.

- Inställningen under "filtyp".

- Dokumentvariabler i `.kateconfig`.

- Dokumentvariabler i själva dokumentet.

- Inställningar som görs under redigering från menyn eller kommandoraden.

Som du märker överskrids dokumentvariabler av ändringar som görs under körning. Så fort ett dokument sparas, läses dokumentvariablerna om, och skriver över ändringar som gjorts med menyalternativ eller från kommandoraden.

Alla variabler som inte anges nedan lagras i dokumentet och kan läsas av andra objekt, exempelvis insticksprogram, som kan använda dem för egna syften. Det variabelbaserade indenteringsläget använder till exempel dokumentvariabler för sin inställning.

Variablerna som anges här dokumenterar &kappname; version 3.7. Fler variabler kan läggas till i framtiden. Det finns tre möjliga typer av värden för variabler, med följande giltiga uttryck:

- BOOL - on|off|true|false|1|0

- HELTAL - vilket heltal som helst

- STRÄNG - allt annat

### Tillgängliga variabler

    auto-center-linesHELTAL

  Ställ in antal rader för automatisk centrering.

    auto-insert-doxygenBOOL

  Sätt på eller stäng av infogning av inledande asterisk i Doxygen-kommentarer. Detta har ingen effekt om du inte använder automatisk indentering med C-stil.

    background-colorSTRÄNG

  Ställ in dokumentets bakgrundsfärg. Värdet måste vara något som kan tolkas som en giltig färg, till exempel `#ff0000`.

    backspace-indentsBOOL

  Aktivera eller inaktivera avindentering när backsteg trycks ner.

    block-selectionBOOL

  Sätt på eller stäng av blockmarkering.

    bom | byte-order-markerBOOL

  Aktivera eller inaktivera byte-ordningsmarkören när filer sparas med Unicode-format (utf8, utf16, utf32).

  Sedan: Kate 3.4 (KDE 4.4)

    encodingSTRÄNG

  Ange kodningen som används för att läsa in eller spara filen. Eftersom variablerna i dokumentet kommer att läsas av efter inläsningen, påverkar detta bara när filen sparas. Om du placerar det i filen `.kateconfig`, får det också effekt vid inläsning.

  Sedan: Kate 3.10 (KDE 4.10)

    bracket-highlight-colorSTRÄNG

  Ställer in färgen för markering av parenteser. Värdet måste vara något som kan tolkas som en giltig färg, till exempel `#ff0000`.

    current-line-colorSTRÄNG

  Ställer in färgen för nuvarande rad. Värdet måste vara något som kan tolkas som en giltig färg, till exempel `#ff0000`.

    default-dictionarySTRÄNG

  Ställer in förvald ordlista använd vid stavningskontroll.

  Sedan: Kate 3.4 (KDE 4.4)

    dynamic-word-wrapBOOL

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

    eol | end-of-lineSTRÄNG

  Ställer in radslutsläget. Giltiga inställningar är `unix`, `mac` och `dos`.

    folding-markersBOOL

  Sätter på eller stänger av visning av vikmarkörer.

    font-sizeHELTAL

  Ställer in teckenstorleken i punkter för dokumentets teckensnitt.

    fontSTRÄNG

  Ställer in dokumentets teckensnitt. Värdet måste vara ett giltigt teckensnittsnamn, till exempel `courier`.

    hl | syntaxSTRÄNG

  Ställer in syntaxfärgläggning. Giltiga strängar är alla namn tillgängliga i menyerna. Skriv exempelvis helt enkelt `C++` för C++.

    icon-bar-colorSTRÄNG

  Ställer in ikonradens färg. Värdet måste vara något som kan tolkas som en giltig färg, till exempel `#ff0000`.

    icon-borderBOOL

  Sätter på eller stänger av visning av ikonkanten.

    indent-modeSTRÄNG

  Ställer in automatiskt indenteringsläge. Alternativen `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` och `xml` känns igen. Se avsnittet för detaljinformation.

    indent-widthHELTAL

  Ställ in indenteringsbredden.

    keep-extra-spacesBOOL

  Ställer in om extra mellanslag ska behållas när indenteringsbredden beräknas.

    line-numbersBOOL

  Sätt på eller stäng av visning av radnummer.

    mixed-indentBOOL

  Sätter på eller stänger av blandad indentering a la Emacs.

  Observera: Användning avråds från sedan Kate 3 i KDE4. Variabeln ignoreras, använd `replace-tabs on;` istället i framtiden.

    newline-at-eofBOOL

  Lägg till en tom rad i slutet av filen (EOF) när dokumentet sparas.

  Sedan: Kate 3.9 (KDE 4.9)

    overwrite-modeBOOL

  Sätter på eller stänger av överskrivningsläge.

    persistent-selectionBOOL

  Sätt på eller stäng av långlivade markeringar.

    remove-trailing-spaceBOOL

  Sätter på eller stänger av dynamisk korrigering av radslut.

  Observera: Användning avråds från sedan KDE 4.10. Använd remove-trailing-spaces med önskat val istället.

    remove-trailing-spacesSTRÄNG

  Tar bort avslutande mellanslag när dokumentet sparas. Giltig alternativ är:

  - `none`, `-` eller `0`: ta aldrig bort avslutande mellanslag.

  - `modified`, `mod`, `+` eller `1`: ta bara bort avslutande mellanslag på ändrade rader. De ändrade raderna markeras av radändringssystemet.

  - `all`, `*` eller `2`: ta bort avslutande mellanslag i hela dokumentet.

  Sedan: KDE 4.10. Detta gör att användning av alternativen `remove-trailing-space` och `replace-trailing-space-save` avråds från.

    replace-tabs-saveBOOL

  Sätter på eller stänger av konvertering av tabulatortecken till mellanslag.

    replace-tabsBOOL

  Sätter på eller stänger av dynamisk konvertering av tabulatortecken till mellanslag.

    replace-trailing-space-saveBOOL

  Sätter på eller stänger av korrigering av radslut när dokumentet sparas.

  Observera: Användning avråds från sedan KDE 4.10. Använd remove-trailing-spaces med önskat val istället.

    schemeSTRÄNG

  Ställer in färgschemat. Strängen måste vara namnet på ett färgschema som finns i dina inställningar för att ha någon effekt.

    selection-colorSTRÄNG

  Ställer in markeringsfärgen. Värdet måste vara något som kan tolkas som en giltig färg, till exempel `#ff0000`.

    show-tabsBOOL

  Sätter på eller stänger av synligt tabulatortecken.

    smart-homeBOOL

  Sätter på eller stänger av smart Home-navigering.

    space-indentBOOL

  Sätter på eller stänger av indentering med mellanslag.

  Observera: Användning avråds från sedan Kate 3 i KDE4. Blandad indentering är standardbeteende. Använd `replace-tabs on;` för att åstadkomma indentering med bara mellanslag.

    tab-indentsBOOL

  Sätter på eller stänger av indentering med tabulatortecken.

    tab-widthHELTAL

  Ställer in tabulatorvisningsbredden.

    undo-stepsHELTAL

  Ställer in antalet ångra-steg som ska kommas ihåg.

  Observera: Användning avråds från sedan Kate 3 i KDE4. Variabeln ignoreras. Det maximala antalet steg som kan ångras är obegränsat.

    word-wrap-columnHELTAL

  Ställer in bredden för hård radbrytning.

    word-wrap-marker-colorSTRÄNG

  Ställer in färgen som markerar radbrytningar. Värdet måste vara något som kan tolkas som en giltig färg, till exempel `#ff0000`.

    word-wrapBOOL

  Sätter på eller stänger av hård radbrytning.