# Att anpassa &kappname;

Genom att välja Inställningar Anpassa `program`... i menyn visar dialogrutan Anpassa. 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.

Du 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 Utseende, Teckensnitt och färger, Redigering, Öppna/spara och Utökningar beskrivs i detalj nedan.

## Inställning av editorkomponenten

Den här gruppen innehåller alla sidor som hör till editorkomponenten i &kappname; De flesta inställningarna här är förvalda, och kan överskridas genom att definiera en filtyp, genom dokumentvariabler eller genom att ändra dem per dokument under en redigeringssession.

### Utseende

#### Allmänt

Editorns teckensnitt

- Här kan du välja teckensnitt för editorns text. Du kan välja bland alla teckensnitt som är tillgängliga i systemet, och ange en normal storlek och kodning. Ett textexempel visas längst ner i dialogrutan, så att du kan se effekten av det du väljer.

  För mer information om hur man väljer ett teckensnitt, se avsnittet Välja teckensnitt i dokumentet &kde;:s grunder.

Visa indikering av blanktecken

- Aldrig

- Editorn visar aldrig punkter för att indikera närvaron av blanktecken.

Vid radens slut

- Editorn kommer att visa punkter som indikerar närvaron av extra blanktecken i slutet av rader.

Alltid

- Editorn visar alltid punkter för att indikera närvaron av blanktecken.

Storlek på indikering av blanktecken

- Använd skjutreglaget för att ändra storlek på den synliga markören.

Visa tabulatormarkörer

- När markerat, visar editorn symbolen » för att indikera närvaron av en tabulator i texten.

Visa fokusram omkring editorn

- När markerat, visar editorn en fokusram omkring den huvudsakliga textpanelen.

Parentesmatchning

- Markera område mellan samhörande parenteser

- Om det här är aktiverat, markeras området mellan de valda samhörande parenteserna.

Visa förhandsgranskning av motsvarande inledande parentes

- När aktiverat, visar editorn ett verktygstips för motsvarande inledande parentes.

Blinka matchande parentes när markören flyttas till den andra parentesen i ett par

- Om aktiverad och man går till en parentes ({, [, ], },( eller )) så blinkar den motsvarande parentesen snabbt.

Visa indenteringslinjer

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

Antal

- Visa antal ord

- Visar antal ord och tecken i dokumentet och aktuell markering i statusraden. Alternativet är också tillgängligt i statusradens sammanhangsberoende meny.

Visa antal rader

- Visar totalt antal rader i dokumentet i statusraden. Alternativet är också tillgängligt i statusradens sammanhangsberoende meny.

Fäll ihop första raden

- Om aktiverad fälls den första raden ihop om möjligt. Det är användbart om filen börjar med en kommentar, såsom en copyright.

Dynamisk radbrytning

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

  Dynamisk radbrytning vid statisk radbrytningsmarkör

- När markerat, bryter editorn rader dynamiskt vid den statiska radbrytningspositionen.

Bortse från ordgränser vid dynamisk radbrytning

- När markerat, tar inte editorn hänsyn till ordgränser när textrader brytes.

Dynamiska radbrytningsmarkörer

- Välj när dynamiska radbrytningsmarkörer ska visas, antingen Av, Följ radnummer eller Alltid på .

Indentera radbrutna rader

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

Radhöjdsmultiplikator

- Värdet multipliceras med teckensnittets förvalda radhöjd. Värdet 1,0 betyder att förvald höjd används.

#### Kanter

Vikning av kodblock

- Visa pilar för att dra ihop kodblock

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

Visa förhandsgranskning av vikta block när muspekaren hålls över

- Om markerat, visas en förhandsgranskning av den hopvikta texten i en meddelanderuta när musen hålls över en hopvikt region.

Vikningspilarnas synlighet

- Ändra vikningspilarna mellan Visa när musen hålls över och Visa alltid.

Vänsterkant

- Visa markörer

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

Markera ändrade och osparade rader

- Om det här är markerat, visas markörer av radändringar. För mer information,se kate-part-line-modification.

Rullningslister

- Visa markörer

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

Visa förhandsgranskning när muspekaren hålls över rullningslister

- Om alternativet är markerat, och du håller muspekaren över rullningslisten, visas en liten textförhandsgranskning med flera rader i det nuvarande dokumentet omkring pekarens position. Det låter dig snabbt gå till en annan del av dokumentet.

Miniavbildning

- Visa miniavbildning

- Om det här alternativet är markerat visar varje ny vy en miniavbildning av dokumentet på den vertikala rullningslisten.

  För mer information om rullningslistens miniavbildning, se kate-part-scrollbar-minimap.

Miniavbildningens bredd

- Justerar bredden på rullningslistens miniavbildning, definierad i bildpunkter.

Rullningslisternas synlighet

- Visa rullningslisten, dölj den eller visa bara rullningslisten när det behövs. Klicka med vänster musknapp på den blåa rektangeln för att visa radnummerintervallet för dokumentet som visas på skärmen. Håll vänster musknapp nertryckt utanför den blåa rektangeln för automatiskt förflyttning genom dokumentet.

Sortera menyn bokmärken

- Enligt skapat datum

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

Enligt radnummer

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

### Färgteman

Den här sidan i dialogrutan låter dig ställa in alla färger i de olika färgteman du har, och skapa nya teman, ta bort befintliga eller bara Följa systemets färgschema. Varje tema har inställningar av färger, normal och markerad textstil.

&kappname; väljer temat som för närvarande är aktivt i förväg åt dig. Om du vill arbeta med ett annat tema, börja med att välja det med kombinationsrutan Välj tema. Du kan skapa ett nytt tema eller ta bort befintliga med knapparna Ny och Ta bort.

Det beskrivs detaljerat i color-themes-gui.

### Redigering

#### Allmänt

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. &kappname; startar automatiskt en ny rad med text när den nuvarande raden når längden som anges av alternativet Bryt rader vid:.

  Bryt rader vid en fast kolumn

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

Rita vertikal linje vid radbrytningskolumnen

- 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 Bryt rader vid en fast kolumn är valt avgör det här värdet längden (i tecken) där editorn automatiskt påbörjar en ny rad.

Standardläge för inmatning

- Det valda inmatningsläget aktiveras när en ny vy öppnas. Du kan fortfarande sätta på eller stänga av Vi-inmatningsläge för en viss vy från menyn Redigera.

Parenteser

- Om alternativet Fyll automatiskt i parenteser när inledande parentes skrivs in är aktiverat när användaren skriver en vänsterparentes ([, (, eller {) skriver &kappname; automatiskt in högerparentesen (}, ), eller ]) till höger om markören.

Omslutande tecken

- Det är möjligt att markera omslutande tecken genom att använda motsvarande kombinationslista.

  När text markeras, radbryts den markerade texten om ett av tecknen skrivs in.

Kopiera och klistra in

- Flytta markerad text vid drag och släpp

- Alternativet aktiverar dra och släpp av den markerade texten inne i editorfönstret.

Kopiera eller klipp ut nuvarande rad utförd utan markerad text

- Om alternativet är aktiverat och textmarkeringen är tom, utförs åtgärderna kopiera och klipp ut för textraden på den verkliga markörpositionen.

Flytta inte textmarkören vid inklistring med musen

- Om alternativet är aktiverat och du klistrar in någon text i editorfönstret genom att klicka med musens mittenknapp, flyttar inte &kappname; textmarkören till den klickade positionen.

#### Textnavigering

Förflyttning av textmarkör

- Smarta Home- och End-tangenter

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

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 &kappname; 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.

Aktivera markörförflyttning till stora bokstäver

- Alternativet ändrar beteendet hos markören när användaren trycker på genvägen &Ctrl;Vänsterpil eller &Ctrl;Högerpil. Om avmarkerat går textmarkören förbi hela ord. Med alternativet markerat, stoppar markörförflyttningen vid stora bokstäver.

Centrera markör automatiskt:

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

Textmarkeringslä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.

Tillåt att rulla förbi dokumentets slut

- Det här alternativet låter dig rulla förbi dokumentets slut. Det kan användas för att centrera dokumentets sista del vertikalt, eller placera det ovanpå den nuvarande vyn.

Backstegstangenten tar bort grundtecknet med diakritiska markeringar

- När de är markerade, tas sammansatta tecken bort med sina diakritiska markeringar istället för att bara ta bort grundtecknet. Det är användbart för Indiska landsinställningar.

Väljare för flera markörer

- Alternativet låter dig ange väljare som används för att skapa flera markörer med vänsterklick. Du måste hålla nere väljarna och klicka med vänster musknapp för att skapa en markör på önskad plats. Se Skapa flera markörer för att ta reda på andra sätt att skapa flera markörer.

#### Indentering

Standardläge för indentering:

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

Indentera med

- Tabulatorer

- När det här är aktiverat, infogar editorn tabulatortecken när du trycker på tabulatortangenten eller använder automatisk indentering.

Mellanslag

- 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 eller använder automatisk indentering.

Tabulatorer och mellanslag

- När det här är aktiverat, infogar editorn mellanslag som beskrivs ovan vid indentering eller när tabulatortangenten används i början av en rad, men infogar tabulatorer när tabulatortangenten används i mitten eller slutet av en rad.

Tabulatorbredd:

- Detta ställer in antal mellanslag som visas istället för ett tabulatortecken.

Indenteringsbredd:

- Indenteringsbredden är antalet mellanslag som används för att indentera en rad. Om indentera med tabulator är inställt, infogas ett tabulatortecken om indenteringen är jämnt delbar med tabulatorbredden.

Indenteringsegenskaper

- Behåll extra mellanslag

- Om alternativet är inaktiverat, justeras en rad till en multipel av bredden som anges med indenteringsbredd när indenteringsnivån ändras.

Justera indentering av text som klistrats in från klippbordet

- Om alternativet markeras, indenteras text som klistras in från klippbordet. Genom att använda alternativet ångra kan indenteringen tas bort.

Indenteringsåtgärder

- Backsteg i inledande blanktecken avindenterar

- Om alternativet är markerat, minskar tangenten Backsteg indenteringsnivån om markören är placerad i de inledande blanktecknen på en rad.

Åtgärd för tabulatortangent (om det inte finns någon markering)

- Om du vill att Tabulator ska justera nuvarande rad i nuvarande kodblock som i &Emacs;, gör Tabulator till en genväg till åtgärden Formatera indentering.

  Gå alltid vidare till nästa tabulatorposition

- Om alternativet är markerat, infogar alltid tangenten Tabulator blanktecken så att nästa tabulatorposition nås. Om alternativet Infoga mellanslag i stället för tabulatorer under fliken Allmänt på sidan Redigering är aktiverat, infogas mellanslag. Annars infogas ett enda tabulatortecken.

Öka alltid indenteringsnivån

- Om alternativet är markerat, indenterar alltid tangenten Tabulator raden med det antal teckenpositioner som anges av Indenteringsbredd.

Öka indenteringsnivån om i inledande blanktecken

- Om alternativet är markerat, indenterar antingen tangenten Tabulator nuvarande rad eller går vidare till nästa tabulatorposition. Om markörens position är på eller före det första tecknet som inte är ett blanktecken på raden, eller om det finns en markering, indenteras nuvarande rad med det antal teckenpositioner som anges av Indenteringsbredd. Om markörens position är efter det första tecknet som inte är ett blanktecken på raden och det inte finns någon markering, infogas blanktecken så att nästa tabulatorposition nås: om alternativet Infoga mellanslag i stället för tabulatorer under Redigering är aktiverat, infogas mellanslag. Annars infogas ett enda tabulatortecken.

#### Automatisk komplettering

Allmänt

- Aktivera automatisk komplettering

- Om aktiverad, dyker en ordkompletteringsruta automatiskt upp vid inskrivning, som visar en lista med texter som kompletterar texten som för närvarande är under markören.

Välj första kompletteringspost automatiskt

- Om aktiverad, är alltid det första objektet i automatisk komplettering förvalt så att du kan infoga det med returtangenten. Om du inte vill ha det beteendet, t.ex. om du vill trycka på returtangenten för att bara infoga en nyrad, inaktivera då det här alternativet.

Minimal ordlängd att komplettera

- Medan du skriver in text, söker ordkomplettering efter ord i dokumentet som börjar med texten som redan skrivits in. Alternativet ställer in det minsta antal tecken som behövs för att aktivera ordkompletteringen och visa en kompletteringsruta.

Ta bort slutet vid komplettering

- Ta bort slutet av ett föregående ord när kompletteringsobjektet väljes i en lista.

Nyckelordskomplettering

- Om aktiverad, använder den inbyggda automatiska kompletteringen nyckelorden definierade av syntaxfärgläggningen.

#### Stavningskontroll

De här inställningsalternativen beskrivs i dokumentationen för modulen Stavningskontroll i systeminställningarna.

#### VI-inmatningsläge

Allmänt

- Låt Vi-kommandon överskrida genvägar i Kate

- Om markerad, överskrider Vi-kommandon &kappname;s inbyggda kommandon. Exempel: &Ctrl;R gör om, och överskrider standardåtgärden (att visa dialogrutan för sökning och ersättning).

Visa relativa radnummer

- Om det här är aktiverat, refererar aktuell rad alltid till rad 0. Rader ovanför och nedanför ökar radnumret relativt.

Tangentavbildning

- Tangentavbildning används för att ändra betydelsen hos inskrivna tecken. Det låter dig flytta kommandon till andra tangenter, eller trycka på särskilda tangenter för att utföra en serie kommandon.

  Exempel:

  F2 -> `I--` Esc

  Lägger till `!--` först på en rad när F2 trycks ner.

### Öppna/spara

#### Allmänt

Filformat

- Kodning

- Det här definierar standardkodningen som ska användas för att öppna och spara filer, om den inte ändras i dialogrutan för att öppna eller spara, eller genom att använda en kommandoradsväljare.

Detektering av kodning

- Välj ett värde i kombinationsrutan, för att antingen inaktivera automatisk detektering eller använda Allmän för att aktivera automatisk detektering av alla kodningar. Men eftersom den troligen bara detekterar UTF-8 eller UTF-16, erhålls bättre resultat genom att välja ett område för att använda anpassade metoder. Om varken kodningen vald som standard ovan, eller kodningen angiven i dialogrutan för att öppna eller spara motsvarar filens innehåll, utförs den här detekteringen.

Reservkodning

- Det här definierar reservkodningen att prova för att öppna filer, om kodningen definierad som standard ovan, eller den som anges via dialogrutan för att öppna eller spara, inte motsvarar filens innehåll. Innan den provas, görs ett försök att bestämma kodningen genom att läsa en möjlig byte-ordningsmarkering i början av filen. Om någon sådan hittas, väljes riktig Unicode-kodning, annars utförs kodningsdetektering. Om båda misslyckas provas reservkodningen.

Radens slut

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

Aktivera byte-ordningsmarkering (BOM)

- Byte-ordningsmarkören är en speciell sekvens i början av dokument kodade med Unicode. Den hjälper editorer att öppna textdokument med riktig Unicode-kodning. För mer information, se Byte Order Mark.

Radlängdsgräns

- Tyvärr får &kappname; dålig prestanda vid arbete med extremt långa rader, på grund av brister i &Qt;. Av den orsaken bryter &kappname; automatiskt rader när de är längre än antalet tecken som anges här. För att inaktivera det, ställ in den till `0`.

Automatisk rensning vid spara

- Ta bort mellanslag i slutet av en rad

- Editorn tar automatiskt bort extra mellanslag i slutet på textrader när filen sparas. Du kan välja Aldrig för att inaktivera funktionen, På ändrade rader för att bara göra det på rader som du har ändrat sedan dokumentet senast sparades, eller I hela dokumentet för att ta bort dem ovillkorligt i hela dokumentet.

Lägg till radbrytning sist i filen när den sparas

- Editorn lägger automatiskt till en nyrad i slutet av filen om det inte redan finns en när filen sparas.

Aktivera spara automatisk (bara för lokala filer)

- Markera det om du vill att editorn ska spara dokument automatiskt medan du arbetar med dem.

  Spara dokument automatiskt när fokus lämnar editorn

- Editorn sparar automatiskt dokument när du byter till någonting utanför editorn, t.ex. terminalrutan i &kate;.

Intervall för spara automatiskt

- Du kan bestämma intervallet för spara automatiskt i sekunder här. Om intervallet är 0, sparas inte dokumentet efter ett intervall.

#### Avancerat

Skriv en säkerhetskopia vid spara för

- Säkerhetskopiering när du sparar gör att &kappname; kopierar filen på disk (den tidigare sparade filen) till <prefix><filnamn><suffix> innan de nya ändringarna sparas. En säkerhetskopia kan vara till hjälp för att återställa arbete om något går fel när du sparar, eller om du senare vill återställa den tidigare versionen av filen. Suffixet har normalt vä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 för säkerhetskopierade filer

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

Suffix för säkerhetskopierade filer

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

Växlingsfilsläge

- &kappname; kan återställa (det mesta) osparade arbetet i händelse av en krasch eller strömavbrott. En växlingsfil (.<filnamn>.kate-swp) skapas när ett dokument redigeras. Om användaren inte sparar ändringarna och &kappname; kraschar, förblir växlingsfilen på disk. När en fil öppnas, kontrollerar &kappname; om det finns en växlingsfil för dokumentet, och om det gör det, frågar användaren om förlorad data ska återställas eller inte. Användaren har också möjlighet att granska skillnaderna mellan originalfilen och den återställda filen. Växlingsfilen tas bort varje gång dokumentet sparas, och vid normal avslutning.

  &kappname; synkroniserar växlingsfilen på disk var 15:e sekund, men bara om det finns ändringar sedan den senaste synkroniseringen. Användaren kan inaktivera synkroniseringen av växlingsfiler om det önskas, genom att välja Inaktivera, men det kan leda till förlust av mer data.

  När växlingsfilen är aktiverad är det möjligt att byta mellan två lägen, närmare bestämt Aktiverad, lagra i förvald katalog och Aktiverad, lagra i egen katalog.

Lagra växlingsfiler i

- Normalt sparas växlingsfiler i samma katalog som filen. När Aktiverad, lagra i egen katalog väljes, skapas växlingsfiler i den angivna katalogen. Det är användbart för nätverksfilsystem för att undvika onödig nätverkstrafik.

Spara växlingsfiler var

- &kappname; synkroniserar växlingsfilen på disk var 15:e sekund, men bara om det finns ändringar sedan den senaste synkroniseringen. Du kan ändra synkroniseringsintervallet som du vill.

#### Lägen och 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 &kappname;s inställningar för filer som väljes av den här Mime-typen genom att använda variabler i &kappname;. Du kan ställa in nästan alla inställningsalternativ, såsom färgläggning, indenteringsläge, etc.

  Klicka på Redigera för att se en lista med alla tillgängliga variabler och deras beskrivningar. Markera kryssrutan till vänster för att aktivera en viss variabel och ange därefter variabelns värde till höger. Vissa variabler tillhandahåller en kombinationsruta för att välja möjliga värden medan andra kräver att du matar in ett giltigt värde manuellt.

  För fullständig information om dessa variabler, se Anpassa med dokumentvariabler.

Färgläggning:

- Om du skapar en ny filtyp, låter den här kombinationsrutan dig välja en filtyp för färgläggning.

Indenteringsläge:

- Kombinationsrutan anger indenteringsläget för nya dokument.

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.

## Anpassa med dokumentvariabler

Variabler i &kappname; är &kappname;s 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 &javascript;-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. Dokumentvariabler i `.kateconfig` använder samma syntax som modelines, men med utökade alternativ.

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

&kappname; har stöd för att läsa inställningar från `.editorconfig`-filer, där biblioteket editorconfig är installerat. &kappname; söker automatiskt efter `.editorconfig` så fort en fil öppnas. Den ger dock prioritet till `.kateconfig`-filer.

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

- Aktivera automatisk infogning av hakparenteser.

    auto-center-linesHELTAL

- Ange rader för automatisk centrering.

    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-mark | byte-order-markerBOOL

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

  Sedan: &kate; 3.4 (&kde; 4.4)

    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.

    folding-previewBOOL

- Aktivera förhandsgranskning av vikning längs editorns kant.

    font-sizeHELTAL

- Ange dokumentets teckenstorlek i punkter.

    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

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

    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.

    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.

    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.

    scrollbar-minimapBOOL

- Visa rullningslistens miniavbildning.

    scrollbar-previewBOOL

- Visa rullningslistens förhandsgranskning.

    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.

    tab-indentsBOOL

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

    tab-widthHELTAL

- Ställer in tabulatorvisningsbredden.

    undo-stepsHELTAL

- Ange antalet ångra-steg som ska kommas ihåg ( = oändigt)

  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.

### Utökade alternativ i `.kateconfig`-filer

&kappname; letar alltid efter en `.kateconfig`-fil för lokala filer (inte fjärrfiler). Dessutom är det möjligt att ange alternativ baserat på jokertecken (filändelser) enligt följande:

    kate: tab-width 4; indent-width 4; replace-tabs on;
    kate-wildcard(*.xml): indent-width 2;
    kate-wildcard(Makefile): replace-tabs off;

I exemplet använder alla filer tabulatorbredd (tab-width) 4 mellanslag, indenteringsbredd (indent-width) 4 mellanslag och tabulatorer ersätts expanderade till mellanslag. För alla `*.xml`-filer är dock indenteringsbredden inställd till 2 mellanslag. Och Makefile-filer använder tabulatorer, dvs. tabulatorer ersätts inte med mellanslag.

Jokertecken skiljs åt av semikolon, dvs. det går också att ange flera filändelser enligt följande:

    kate-wildcard(*.json;*.xml): indent-width 2;

Dessutom kan &MIME;-typer också användas för att matcha vissa filer, för att t.ex. indentera all C++ källkodsfiler med 4 mellanslag kan man skriva:

    kate-mimetype(text/x-c++src): indent-width 4;

Förutom stödet i `.kateconfig`-filer, stöds också dokumentvariabler som beror på jokertecken och &MIME;-typer i själva filerna som kommentarer.