# &kate; einrichten

## Überblick

&kate; bietet viele Möglichkeiten, mit Feineinstellungen die Anwendung wie gewünscht reagieren zu lassen. Die wichtigsten sind:

Der Einrichtungsdialog

- Das Haupteinrichtungsfenster, in dem wichtige Einstellungen für &kate;, das Editorfenster und die Nutzung von Erweiterungen vorgenommen werden.

Das Menü Einstellungen

- Dieses Menü enthält oft benutzte Einstellungen und dient zum Öffnen der Einstellungsdialoge.

Das Menü Ansicht

- Gestattet die Teilung des aktiven Rahmens, sowie das Ein- und Ausschalten von Symbol- und Zeilennummernspalte für das aktive Dokument.

Als eingebetteter Terminal-Emulator wird die in den Systemeinstellungen ausgewählte Standardkomponente benutzt. Durch Klicken mit der rechten Maustaste kann ein Kontextmenü mit Optionen zur Einrichtung des Terminals geöffnet werden.

## Der Haupteinrichtungsdialog

Der &kate;-Haupteinrichtungsdialog zeigt eine Baumstruktur links und eine Seite mit Einstellungen zu dem links ausgewählten Thema auf der rechten Seite.

Die Einstellungen sind in zwei Gruppen unterteilt, nämlich

- Programm

- Editor

## Die Einstellungen zum Programm

Diese Gruppe enthält Seiten mit Einstellungen der &kate;-Anwendung.

### Allgemein

Diese Seite enthält einige globale Einstellungen von &kate;

Verhalten

- Warnung ausgeben, sobald Dateien von fremden Programmen geändert wurden.

- Wenn eingeschaltet, dann gibt &kate; eine Meldung aus, sobald geöffnete Dateien von anderen Anwendungen geändert wurden. Die Meldung wird immer dann ausgegeben, wenn das Hauptfenster den Fokus erhält. Sie können mit mehreren geänderten Dateien gleichzeitig arbeiten, Sie können erneut laden, sichern oder die Änderungen in den Dateien ignorieren, alles das in Gruppen.

  Wenn nicht eingeschaltet, dann wird &kate; Sie fragen was getan werden soll, wenn eine von einer anderen Anwendung geänderte Datei den Fokus in &kate; bekommt.

Meta-Information

- Meta-Information über Sitzungen hinaus speichern

- Wenn eingeschaltet, speichert &kate; Meta-Informationen wie Lesezeichen und Sitzungseinstellungen auch wenn Sie die Dokumente schließen. Die Informationen werden benutzt, wenn das Dokument beim erneuten Öffnen unverändert ist.

Unbenutzte Meta-Information löschen nach

- Setzt die Anzahl der Tage, für die die Meta-Informationen für früher geöffnete Dateien behalten werden. Dadurch kann die Datenbasis auf eine vernünftige Größe begrenzt werden.

### Sitzungen

Dieser Abschnitt enthält Einstellungen, die im Abschnitt Benutzen von Sitzungen beschrieben werden.

Sitzungsbestandteile

- Fenstereinstellungen einbeziehen

- Wenn eingeschaltet, sichert &kate; die Fenstereinstellungen mit jeder Sitzung.

Verhalten beim Programmstart

- Hier stellen Sie ein, wie sich &kate; beim Start verhält. Diese Einstellung kann in der Befehlszeile überschrieben werden.

  Neue Sitzung starten

- Mit dieser Einstellung startet &kate; eine neue unbenannte Sitzung beim Programmstart.

Zuletzt verwendete Sitzung laden

- &kate; benutzt die zuletzt geöffnete Sitzung beim Programmstart. Diese Einstellung ist optimal, wenn Sie immer dieselbe Sitzung verwenden oder die Sitzungen nur selten ändern wollen.

Sitzung manuell auswählen

- &kate; zeigt ein kleines Dialogfenster, in dem Sie eine Sitzung auswählen oder die Standardsitzung laden können, wenn es noch keine früher gespeicherten Sitzungen gibt. Optimal, wenn Sie viele verschiedene Sitzungen verwenden.

Jede Änderung der Sitzungsdaten (geöffnete Dateien und - wenn aktiviert - auch die Fenstereinstellung) werden immer gespeichert.

### Erweiterungen

Diese Seite zeigt eine Liste mit allen installierten Erweiterungen für &kate; an. Jede Erweiterung wird in der Liste mit Namen und einer kurzen Erläuterung angezeigt. Sie können mit dem Ankreuzfeld die Erweiterung zur Verwendung einschalten.

Wenn eine Erweiterung eine Seite mit Einstellungen für diese Erweiterung bereitstellt, dann wird diese Seite als Unterseite der Seite Erweiterungen in das Menü eingefügt.

Weitere Informationen über die verfügbaren Module finden Sie im Abschnitt plugins.

### Dokumente

Hintergrundschattierung

- Auf dieser Seite können Sie einstellen, ob der Hintergrund kürzlich geöffneter Dokumente in der Dokumentliste eingefärbt werden und in welchen Farben dies geschehen soll. Im Abschnitt Die Dokumentliste finden Sie nähere Erläuterungen hierzu.

Sortieren nach:

- Stellt ein, wie die Dokumentliste sortiert wird. Diese Einstellung kann auch vom mit der &RMBn; aufrufbaren Menü vorgenommen werden.

Ansichtsmodus

- Hier gibt es zwei Einstellungen, die die Anzeige in der Werkzeugansicht Dokumente beeinflussen. Mit Baumansicht werden die Dokumente unterhalb der Ordner, in denen sie sich befinden, angezeigt, während die Listenansicht eine flache Liste der Dokumente anzeigt.

Vollständigen Pfad anzeigen

- Wenn die Baumansicht und diese Einstellung aktiviert sind, zeigen die Ordnereinträge in der Werkzeugansicht Dokumente den vollständigen Pfad zum Ordner im Dateisystem zusätzlich zum Namen des Ordners. Dies hat in der Listenansicht keinen Effekt.

&configuring-part-sections;

## Einstellungen mit Dokumentvariablen

&kappname; Variablen sind Kateparts Dokumentvariablen, ähnlich der Modelines in &Emacs; und Vi. In Katepart haben die Dokumentvariablen das folgende Format: `kate: VARIABLENAME VALUE; [ VARIABLENAME VALUE; ... ]`. Die Zeilen können natürlich auch in einem Kommentar stehen, wenn das Format des Dokuments Kommentare beinhaltet. Variablennamen sind einzelne Wörter ohne Zwischenräume und alles bis zum nächsten Semikolon sind Werte. Das Semikolon ist vorgeschrieben.

Hier ein Beispiel für eine Variablenzeile, die die Einrückung für Quelltext in C++, java oder javascript einschaltet:

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

Nur die ersten und letzten 10 Zeilen eines Dokuments werden nach Dokumentvariablen durchsucht.

Zusätzlich können Dokumentvariablen in eine Datei mit dem Namen `.kateconfig` in jedem beliebigen Ordner geschrieben werden. Die Einstellungen dieser Dokumentvariablen werden so verwendet, als wenn sie als Modelines in jeder Datei im Ordner und allen Unterordnern bis zur in eingestellten Suchtiefe eingefügt wäre. Dokumentvariablen in `.kateconfig` verwenden die gleiche Syntax wie Modelines.

Es gibt für fast alle Einstellungen in katepart. Außerdem können Module Variablen benutzen. In diesem Fall sind sie in der Dokumentation der Module dokumentiert.

### Wie &kappname; Variablen benutzt

Beim Einlesen der Einstellungen werden von katepart

- die globalen Einstellungen,

- optionale Daten zur aktuellen Sitzung,

- die Einstellungen zum Dateityp,

- Dokumentvariablen in `.kateconfig`,

- Variablen im Dokument selbst,

- Einstellungen während der aktuellen Sitzung über das Menü oder die Befehlszeile

in der angegebenen Reihenfolge gelesen und angewendet. Wie Sie sehen, werden Dokumentvariablen nur durch Änderungen zur Laufzeit überschrieben. Immer wenn ein Dokument gespeichert wird, werden die Dokumentvariablen neu eingelesen und überschreiben dann von der Befehlszeile oder über das Menü vorgenommene Einstellungsänderungen.

Jede hier nicht beschriebene Variable ist im Dokument gespeichert und kann durch andere Objekte wie Erweiterungen abgefragt werden, die diese Variablen für ihre eigenen Zwecke setzen können. Zum Beispiel nutzt der Modus für die Variablenbasierte-Einrückung Dokumentvariablen zum Speichern der Einstellungen.

Die hier beschriebenen Variablen sind in &kappname; Version 3.7 enthalten. Es werden in der Zukunft sicher weitere Variablen hinzugefügt werden. Es gibt drei Typen von Variablen mit den folgenden gültigen Werten:

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

- INTEGER - eine ganze Zahl

- STRING - alles andere

### Verfügbare Variablen

    auto-center-linesINT

- Setzt die Anzahl der automatisch zentrierten Zeilen.

    auto-insert-doxygenBOOL

- Schaltet das Einsetzen von vorangehenden Sternen in doxygen-Kommentaren ein und aus. Dieser Befehl wird nur bei Benutzung von automatischem Einrücken im C-Stil wirksam.

    background-colorSTRING

- Setzt die Hintergrundfarbe des Dokuments. Der Wert muss als gültige Farbe ausgewertet werden können, also ⪚ `#ff0000`.

    backspace-indentsBOOL

- Schaltet die Verringerung des Einrückens beim Drücken der Taste &Backspace; ein oder aus.

    block-selectionBOOL

- Schaltet die Blockauswahl ein und aus.

    bom | byte-order-markerBOOL

- Schaltet die Markierung für die Bytereihenfolge ein und aus, wenn Dokumente in einem Unicodeformat (utf8, utf16, utf32) gespeichert werden.

  Ab Version: &kate; 3.9 (&kde; 4.9)

    encodingSTRING

- Bestimmt die Kodierung für das Laden und Speichern der Datei. Da die Variablen im Dokument erst nach dem Laden gelesen werden, beeinflußt diese Option nur das Speichern. Verwenden Sie diese Option in einer `.kateconfig`-Datei, wird die gesetzte Kodierung auch beim Laden benutzt.

  Ab Version: &kate; 3.10 (&kde; 4.10)

    bracket-highlight-colorSTRING

- Setzt die Hintergrundfarbe für die Hervorhebung von Klammern. Der Wert muss als gültige Farbe ausgewertet werden können, also ⪚ `#ff0000`.

    current-line-colorSTRING

- Setzt die Farbe für die aktuelle Zeile. Der Wert muss als gültige Farbe ausgewertet werden können, also ⪚ `#ff0000`.

    default-dictionarySTRING

- Legt das Standardwörterbuch für die Rechtschreibprüfung fest.

  Ab Version: &kate; 3.9 (&kde; 4.9)

    dynamic-word-wrapBOOL

- Schaltet den dynamischen Zeilenumbruch ein und aus.

    eol | end-of-lineSTRING

- Setzt das Format für das Zeilenende. Gültige Werte hierfür sind: unix, mac und dos.

    folding-markersBOOL

- Schaltet die Anzeige von Quelltextausblendungen ein und aus.

    font-sizeINT

- Setzt die Schriftgröße des Dokuments.

    fontSTRING

- Setzt die Schriftart des Dokuments . Der Wert muss eine gültige Schriftart bezeichnen, also ⪚ `courier`.

    hl | syntaxSTRING

- Setzt den Hervorhebungsmodus. Es können alle Namen, die auch in den Menüs vorhanden sind, verwendet werden. z.B für C++ benutzen Sie einfach `C++`.

    icon-bar-colorSTRING

- Setzt die Farbe des Symbolrandes. Der Wert muss als eine gültige Farbe übersetzt werden können, also ⪚ `#ff0000`.

    icon-borderBOOL

- Schaltet die Anzeige des Symbolrandes ein und aus.

    indent-modeSTRING

- Setzt den Modus für das automatische Einrücken. Die Einstellungen `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` und `xml` sind möglich. Sehen Sie unter Automatisches Einrücken benutzen für Einzelheiten nach.

    indent-pasted-textBOOL

- Aktiviert/deaktiviert die Anpassung der Einrückung von Text, der aus der Zwischenablage eingefügt wird

  Ab Version: &kate; 3.11 (&kde; 4.11)

    indent-widthINT

- Setzt die Breite der Einrückung.

    keep-extra-spacesBOOL

- Legt fest, ob zusätzliche Leerzeichen bei der Berechnung der Einrückungweite beibehalten werden.

    line-numbersBOOL

- Schaltet die Anzeige der Zeilennummern ein und aus.

    mixed-indentBOOL

- Schaltet die gemischte Einrückung im &Emacs;-Stil ein und aus.

  Anmerkung: Ab Version &kate; 3 in &kde; 4 ist diese Variable nicht mehr wirksam, Verwenden Sie stattdessen `replace-tabs on;`.

    newline-at-eofBOOL

- Fügt beim Speichern des Dokuments eine leere Zeile am Ende der Datei (EOF) an.

  Ab Version: &kate; 3.9 (&kde; 4.9)

    overwrite-modeBOOL

- Schaltet den Überschreibmodus ein und aus.

    persistent-selectionBOOL

- Schaltet die durchgehende Auswahl ein und aus.

    remove-trailing-spaceBOOL

- Schaltet das automatische Entfernen von Leerzeichen am Zeilenende ein und aus.

  Hinweis: Seit &kde; 4.10 veraltet. Bitte verwenden Sie stattdessen remove-trailing-spaces mit der gewünschten Auswahl.

    remove-trailing-spacesSTRING

- Entfernt Leerzeichen am Zeilenende beim Speichern des Dokuments. Gültige Optionen sind:

  - `none`, `-` or `0`: Leerzeichen am Zeilenende nie entfernen.

  - `modified`, `mod`, `+` or `1`: Leerzeichen am Zeilenende nur in geänderten Zeilen entfernen. Diese geänderten Zeilen werden durch das Zeilenänderungssystem gekennzeichnet.

  - `all`, `*` or `2`: Leerzeichen am Zeilenende im gesamten Dokument entfernen.

  Seit &kde; 4.10. Diese Funktion ersetzt die veralteten Optionen `remove-trailing-space` und `replace-trailing-space-save`.

    replace-tabs-saveBOOL

- Schaltet das Ersetzen von Tabulatoren durch Leerzeichen beim Speichern des Dokuments ein und aus.

    replace-tabsBOOL

- Schaltet das sofortige Ersetzen von Tabulatoren durch Leerzeichen ein und aus.

    replace-trailing-space-saveBOOL

- Schaltet das automatische Entfernen von Leerzeichen am Zeilenende beim Speichern des Dokuments ein und aus.

  Hinweis: Seit &kde; 4.10 veraltet. Bitte verwenden Sie stattdessen remove-trailing-spaces mit der gewünschten Auswahl.

    schemeZEICHENKETTE

- Setzt das Farbschema von &kate;. Die Zeichenkette muss ein gültiger Name für ein Farbschema sein, sonst wird diese Einstellung ignoriert.

    selection-colorSTRING

- Setzt die Farbe für ausgewählten Text. Der Wert muss als gültige Farbe ausgewertet werden können, also ⪚ `#ff0000`.

    show-tabsBOOL

- Schaltet die Anzeige von Tabulatorzeichen ein und aus.

    smart-homeBOOL

- Schaltet die intelligente Funktion der Tasten Pos1 und Ende ein oder aus.

    space-indentBOOL

- Schaltet das Einrücken mit Leerzeichen ein und aus.

  Anmerkung: Ab Version &kate; 3 in &kde;4 soll diese Variable nicht mehr verwendet werden. gemischte Einrückung im Emacs-Stil ist die Standardeinstellung. Verwenden Sie den Befehl `replace-tabs on;` um auf Einrückung mit Leerzeichen umzustellen.

    tab-indentsBOOL

- Schaltet das Einrücken mit der taste ein und aus.

    tab-widthINT

- Setzt die angezeigte Weite für ein Tabulatorzeichen.

    undo-stepsINT

- Setzt die Anzahl der gespeicherten Schritte für die Funktion Rückgängig.

  Anmerkung: Ab Version &kate; 3 in &kde;4 wird diese Variable ignoriert. Die maximale Anzahl von Schritten für Rückgängig ist unbegrenzt.

    word-wrap-columnINT

- Setzt die Zeilenlänge für den Statischen Zeilenumbruch.

    word-wrap-marker-colorSTRING

- Setzt die Farbe für Zeilenumbruchmarkierungen. Der Wert muss als gültige Farbe ausgewertet werden können, also ⪚ `#ff0000`.

    word-wrapBOOL

- Schaltet den statischen Zeilenumbruch ein und aus.