# 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 också 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 tidigare ö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 programmet 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.

Alla ä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 plugins.

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

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.

&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 kate-part-autoindent för detaljinformation.

    indent-pasted-textBOOL

- Aktivera eller inaktivera Justering av indentering för text som klistrats in från klippbordet.

  Sedan: &kate; 3.11 (&kde; 4.11)

    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, som med &Emacs;.

  Observera: Användning avråds från sedan &kate; 3 i &kde; 4. 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 &kde; 4. 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 &kde; 4. 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.