&Anders.Lund; &Anders.Lund.mail;
&Otto.Bruggeman;&Freek.de.Kruijf;

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

### 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 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 &Tab;-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.