&Anders.Lund; &Anders.Lund.mail;
&Otto.Bruggeman;

# &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 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 niet-geopende bestanden te bewaren. Dit helpt om de database van meta-informatie op een redelijke grootte te houden.

Standaard tekstbewerkingscomponent

  Selecteer de door &kate; te gebruiken tekstbewerkingscomponent. Standaard is het de component zoals geconfigureerd in &systemsettings;.

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

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

### Boomstructuurweergave

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.

Volledig pad tonen

  Indien in boomstructuurweergave geactiveerd, worden de topniveaus getoond met hun volledige pad ipv. met de naam van de laatste map.

### Plug-ins

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

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

### Terminal

Deze pagina wordt alleen getoond bij de plug-in voor terminalweergave, die standaard is ingeschakeld.

De terminal automatisch synchroniseren met het huidige document, wanneer mogelijk

  Dit heeft als gevolg dat de ingebouwde terminal een `cd` doet in de map van het actieve document wanneer gestart en wanneer een nieuw document de focus krijgt. Indien niet ingeschakeld, dan moet u al uw navigatie in de terminal zelf doen.

Stel de omgevingsvariabele EDITOR in op 'kate -b'

  Dit stelt de omgevingsvariabele `EDITOR` in zodat programma's die in de ingebouwde terminal werken die automatisch een bestand in een tekstbewerker openen deze in &kate; openen in plaats daarvan in de standaard tekstbewerker van uw shell. U zult niet in staat zijn met het gebruik van de terminal totdat u het bestand in &kate; hebt gesloten, zodat het aanroepende programma weet dat u klaar bent met het bewerken van het bestand.

&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: space-indent on; indent-width 4; mixedindent off; 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 ziet 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-bracketsBOOL

  Zet automatisch invoegen van haakjes aan of uit.

    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)

    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-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 als in Emacs.

  Opmerking: Verouderd sinds Kate 3 in KDE4. Deze variable wordt genegeerd, gebruik `replace-tabs on;` in plaats hiervan in de toekomst.

    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.

    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.

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

    wrap-cursorBOOL

  Zet regelafbreking aan of uit.