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

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 .

  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 .

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