# &kate; instellen

## Overzicht

&kate; biedt verschillende mogelijkheden om de toepassing te verfijnen om zich te gedragen naar uw wensen. De meest belangrijke zijn:

Het configuratievenster

- De hoofdinstellingen, bieden u de mogelijkheid om de toepassing &kate;, de tekstbewerkercomponent en het gebruik van plugins te configureren.

Het menu Instellingen

- Biedt u de mogelijkheid om vaak gebruikte instellingen te wijzigen en om instellingsdialogen op te starten.

Het menu Beeld

- Biedt u de mogelijkheid het huidige frame te splitsen, eveneens om pictogrammen te tonen en een regelnummerpaneel voor het huidige in bewerking zijnde document.

De ingebedde terminal gebruikt de configuratie gedefinieerd in de &systemsettings; en kan ook worden ingesteld door met de rechter muisknop te klikken om een contextmenu weer te geven.

## De hoofdinstellingendialoog

De instellingendialoog van &kate; toont links een boomstructuur met onderwerpen en rechts een instellingenpagina overeenkomend met het geselecteerde onderwerp.

De instellingen zijn onderverdeeld in twee groepen, namelijk

- Toepassingen instellen

- Instellingen voor de tekstbewerkercomponent

## De instellingen voor de toepassing &kate;

Deze groep bevat pagina's om de hoofd toepassing &kate; in te stellen

### Algemeen

Deze sectie bevat een paar globale opties voor &kate;

Gedrag

- Waarschuwen wanneer bestanden zijn gewijzigd door andere processen

- Indien ingeschakeld zal &kate; u melden, wanneer bestanden buiten de toepassing om zijn gewijzigd, op het moment dat het hoofdvenster invoerfocus krijgt. U zult in staat zijn om verschillende gewijzigde bestanden tegelijk af te handelen, u kunt gewijzigde bestanden in groepen herladen, opslaan of verwijderen.

  Indien niet ingeschakeld zal &kate; u om actie vragen wanneer een extern gewijzigd bestand focus krijgt in de toepassing.

Meta-informatie

- Meta-informatie na sessies behouden

- Indien ingeschakeld zal &kate; metagegevens zoals bladwijzers en configuratie van de sessie zelfs wanneer u uw documenten sluit. De gegevens zullen worden gebruikt als het document ongewijzigd is wanneer het wordt heropend.

Ongebruikte meta-informatie verwijderen na

- Stelt het maximum aantal dagen in om meta-informatie voor eerder geopende bestanden te bewaren. Dit helpt om de database van meta-informatie op een redelijke grootte te houden.

### Sessies

Deze sectie bevat opties die verband houden met het gebruik van sessies.

Elementen van sessies

- Vensterconfiguratie insluiten

- Indien ingeschakeld zal &kate; de vensterconfiguratie van elke sessie opslaan.

Gedrag bij opstarten van programma

- Selecteert hoe u wilt dat &kate; zich gedraagt bij opstarten. Deze instelling kan overschreven worden door te specificeren wat te doen op de commandoregel.

  Nieuwe sessie starten

- Met deze optie zal &kate; een nieuwe sessie zonder naam starten wanneer u de toepassing opstart.

Laatst gebruikte sessie laden

- &kate; zal de meest recent geopende sessie bij opstarten gebruiken. Dit is goed als u dezelfde sessie altijd wilt gebruiken of zelden omschakelt.

Een sessie handmatig kiezen

- &kate; zal een kleine dialoog tonen die u uw sessie met voorkeur laat kiezen of de standaard sessie als er geen is opgeslagen. Dit is het standaard gedrag. Leuk als u frequent heel wat verschillende sessies gebruikt.

Elke wijziging aan de sessiegegevens (geopende bestanden en indien ingeschakeld, vensterconfiguratie) zal altijd worden opgeslagen.

### Plug-ins

Deze pagina levert een lijst met geïnstalleerde plug-ins voor de toepassing &kate;. Elke plug-in wordt gerepresenteerd door zijn naam en een korte beschrijving. U kunt het keuzevakje activeren met een item om de plug-in, die het representeert te activeren.

Als een plug-in instellingsopties levert, dan zal er een sectie, als een subpagina van deze pagina, verschijnen om hiertoe toegang te verlenen.

Voor meer informatie over beschikbare plug-ins, zie plugins.

### Documenten

Achtergrondschaduw

- Deze sectie stelt u in staat om de achtergrondschaduw voor visualisatie van uw recente activiteiten in of uit te schakelen en de te gebruiken kleuren te kiezen, indien ingeschakeld. Zie de sectie over De lijst documenten voor meer over deze functie.

Sorteren op

- Stelt in hoe u de lijst met documenten wilt hebben gesorteerd. Dit kan ook gezet worden met het &RMB; menu in de lijst met documenten.

Weergavemodus

- Dit biedt twee opties die invloed hebben op de weergave van het hulpmiddel voor documenten. De optie Boomstructuurweergave zal de documenten tonen in een boomstructuur onder de mappen waarin ze zich bevinden, terwijl de optie Lijstweergave een vlakke lijst met documenten laat zien.

Volledig pad tonen

- Wanneer Boomstructuurweergave en deze optie zijn ingeschakeld, zullen de mappen in het hulpmiddel voor documentweergave getoond worden met het volledige pad in het bestandssysteem naar de map naast de naam van de map. Het heeft geen effect in de Lijstweergave.

&configuring-part-sections;

## Configureren met documentvariabelen

&kappname;-variabelen is de implementatie van documentvariabelen van katepart, vergelijkbaar met modusregels van &Emacs; en vi. In katepart hebben de regels het volgende formaat `kate: VARIABELENAAM WAARDE; [ VARIABELENAAM WAARDE; ... ]` de regels kunnen zich natuurlijk in commentaar bevinden, als het bestand in een formaat is met commentaar. Variabelennamen zijn enkele woorden (geen witruimte) en alles tot aan de volgende puntkomma is de waarde. De puntkomma is vereist.

Hier is een voorbeeld van een variabelenregel, die instellingen voor inspringen forceert voor een bestand met C++, java of javascript:

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

Alleen in de eerste en laatste 10 regels worden gezocht naar variabelenregels.

Bovendien, kunnen documentvariabelen in een bestand geplaatst worden genaamd `.kateconfig` in elke map en de geconfigureerde instellingen zullen worden toegepast alsof de modusregels ingevoerd zijn op elk bestand in de map en zijn submappen, tot zover als de geconfigureerde zoekdiepte. Documentvariabelen in `.kateconfig` gebruiken dezelfde syntax als die in modusregels.

Er zijn variabelen om bijna alle configuraties in katepart te ondersteunen, en extra plugins kunnen variabelen gebruiken, in welk geval het gedocumenteerd zou moeten zijn in de documentatie van de plugin.

### Hoe &kappname; variabelen gebruikt

Bij het lezen van de instellingen kijkt katepart op de volgende plaatsen (in die volgorde):

- De globale instellingen.

- Optionele sessiegegevens.

- De instellingen voor "Bestandstype".

- Documentvariabelen in `.kateconfig`.

- Documentvariabelen in het document zelf.

- Instellingen die zijn gemaakt tijdens het bewerken uit het menu of vanaf de commandoregel.

Zoals u kunt zien hebben documentvariabelen die gewijzigd zijn tijdens uitvoering voorrang. Wanneer een document wordt opgeslagen zullen de documentvariabelen worden herlezen en zullen de wijzigingen overschrijven die zijn gemaakt door menu-items of door de commandoregel te gebruiken.

Elke variabele, die niet hieronder wordt genoemd, wordt opgeslagen in het document en kan door andere objecten, zoals plugins, worden opgevraagd, die ze voor hun eigen doeleinden kunnen gebruiken. De variabele 'indent-mode' gebruikt bijvoorbeeld documentvariabelen voor zijn configuratie.

De hier getoonde variabelen documenteren &kappname; versie 3.7. Meer variabelen kunnen in de toekomst worden toegevoegd. Er zijn 3 mogelijke typen waarden voor variabelen, met de volgende geldige expressies:

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

- INTEGER - elk geheel getal

- STRING - iets anders

### Beschikbare variabelen

    auto-center-linesINT

- Stelt het aantal autocentreer-regels in.

    auto-insert-doxygenBOOL

- Zet het invoegen van de start-sterretjes in doxygen commentaar aan of uit. Dit heeft geen effect tenzij u de C-style auto-indenteerder gebruikt.

    background-colorSTRING

- Stelt de kleur in kleur in van de achtergrond van het document. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld `#ff0000`.

    backspace-indentsBOOL

- Indentering in- of uitschakelen wanneer &Backspace; wordt ingedrukt.

    block-selectionBOOL

- Zet selectie van blokken aan of uit.

    bom | byte-order-markerBOOL

- Schakelt bytevolgordemarkering in/uit bij het opslaan van bestanden in het formaat unicode (utf8, utf16, utf32).

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

    encodingSTRING

- Stel de te gebruiken codering in voor het laden of opslaan van het bestand. Omdat de variabelen in het document gelezen zullen worden na het laden, heeft dit alleen invloed op het opslaan. Als u het in een bestand `.kateconfig` plaatst, zal het ook van invloed zijn op het laden.

  Sinds: &kate; 3.10 (&kde; 4.10)

    bracket-highlight-colorSTRING

- Stel de kleur in voor accentuering van haakjes. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld `#ff0000`"

    current-line-colorSTRING

- Stelt de kleur in van de huidige regel. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld `#ff0000`".

    default-dictionarySTRING

- Stelt het standaard woordenboek in dat wordt gebruikt voor spellingcontrole.

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

    dynamic-word-wrapBOOL

- Schakelt dynamische regelafbreking in of uit.

    eol | end-of-lineSTRING

- Stelt de modus van einde-regel in. Geldige instellingen zijn `unix`, `mac` en `dos`.

    folding-markersBOOL

- Zet het tonen van invouwmarkering aan of uit.

    font-sizeINT

- Stelt de grootte van het lettertype van het document in in punten.

    fontSTRING

- Stelt het lettertype van het document in. De waarde moet de naam van een geldig lettertype zijn, bijvoorbeeld `courier`.

    hl | syntaxSTRING

- Stelt de accentuering van de syntax in. Geldige tekenreeksen zijn alle namen beschikbaar in de menu's. Bijvoorbeeld voor C++, schrijf eenvoudig `C++`.

    icon-bar-colorSTRING

- Stelt de kleur in de pictogrambalk. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld `#ff0000`.

    icon-borderBOOL

- Zet het tonen van de pictogramrand aan of uit.

    indent-modeSTRING

- Stelt de auto-inspringmodus in. De opties `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` en `xml` worden herkend. Zie de sectie kate-part-autoindent voor details.

    indent-pasted-textBOOL

- Inspringen in-/uitschakelen van tekst geplakt vanaf het klembord

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

    indent-widthINT

- Stelt de inspringbreedte in.

    keep-extra-spacesBOOL

- Stelt in of extra spaties behouden blijven wanneer de inspringbreedte wordt berekend.

    line-numbersBOOL

- Zet het tonen van regelnummers aan of uit.

    mixed-indentBOOL

- Gemengd inspringen in/uitschakelen zoals in &Emacs;.

  Opmerking: Verouderd sinds &kate; 3 in &kde;4. Deze variable wordt genegeerd, gebruik `replace-tabs on;` in plaats hiervan in de toekomst.

    newline-at-eofBOOL

- Voeg een lege regel toe aan het eind van het bestand (EOF) wanneer document wordt opgeslagen.

  Sinds: &kate; 3.9 (&kde; 4.9)

    overwrite-modeBOOL

- Overschrijfmodus aan/uitzetten.

    persistent-selectionBOOL

- Zet blijvende selecties aan of uit.

    remove-trailing-spaceBOOL

- Dynamisch wissen aan het eind van de regel aan/uitzetten.

  Opmerking: Verouderd sinds &kde; 4.10. Gebruik in plaatst daarvan liever verwijder-spaties-aan-het-eind met de gewenste keuze.

    remove-trailing-spacesTEKENREEKS

- Spaties aan het einde van de regel bij het opslaan verwijderen. Geldige opties zijn:

  - `none`, `-` of `0`: nooit spaties aan het einde verwijderen.

  - `modified`, `mod`, `+` of `1`: spaties aan het eind alleen verwijderen in gewijzigde regels. De gewijzigde regels worden gemarkeerd door het regelwijzigingssysteem.

  - `all`, `*` or `2`: spaties aan het eind in het gehele document verwijderen.

  Sinds: &kde; 4.10. Dit maakt dat de opties `remove-trailing-space` en `replace-trailing-space-save` verouderd zijn.

    replace-tabs-saveBOOL

- Zet conversie van tab naar spatie bij opslaan aan of uit.

    replace-tabsBOOL

- Zet dynamische conversie van tab naar spatie aan of uit.

    replace-trailing-space-saveBOOL

- Zet opschonen aan het eind van de regel aan of uit.

  Opmerking: Verouderd sinds &kde; 4.10. Gebruik in plaatst daarvan liever verwijder-spaties-aan-het-eind met de gewenste keuze.

    schemeSTRING

- Stelt het kleurenschema in. De tekenreeks moet de naam van een kleurenschema zijn dat in uw configuratie bestaat om enig effect te hebben.

    selection-colorSTRING

- Stelt de kleur van een selectie in. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld `#ff0000`.

    show-tabsBOOL

- Zet het visuele tab-teken aan of uit.

    smart-homeBOOL

- Zet intelligent navigeren naar de basismap aan of uit.

    space-indentBOOL

- Zet inspringen met spaties aan of uit.

  Opmerking: Verouderd sinds &kate; 3 in &kde;4. Gemengd inspringen is standaard. Stel `replace-tabs on;` om inspringen met alleen spaties te verkrijgen.

    tab-indentsBOOL

- Zet het inspringen met de -toets aan of uit.

    tab-widthINT

- Stelt de weergavebreedte van het tab-teken in.

    undo-stepsINT

- Stelt het aantal te herinneren stappen in.

  Opmerking: Verouderd sinds &kate; 3 in &kde;4. Deze variabele wordt genegeerd. Het maximum aantal stappen voor terugdraaien is ongelimiteerd.

    word-wrap-columnINT

- Stelt breedte in van statische regelafbreking.

    word-wrap-marker-colorTEKENREEKS

- Stelt de kleur in van de marker voor regelafbreking. De waarde moet iets zijn dat geëvalueerd kan worden tot een geldige kleur, bijvoorbeeld `#ff0000`.

    word-wrapBOOL

- Zet statische regelafbreking aan of uit.