# &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: 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 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 kate-part-autoindent 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 -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.