&Anders.Lund; &Anders.Lund.mail;
Thomas
Diehl

    thd@kde.org

GUI-Übersetzung
Matthias
Schulz

    matthias.schulz@kdemail.net

Deutsche Übersetzung

# &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 ungeöffnete Dateien. 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.

  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.

Die Ä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 .

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

### Terminal

Diese Seite wird durch das Terminal-Modul angezeigt. Als Voreinstellung ist dieses Modul aktiviert.

Terminal-Ordner automatisch mit aktuellem Dokument abgleichen (sofern möglich)

  Diese Option bewirkt, dass der eingebaute Terminal-Emulator immer mit `cd` zum Verzeichnis des aktuellen Dokuments wechselt, wenn ein neues Dokument geöffnet wird oder zu einem anderen Dokument umgeschaltet wird. Wenn ausgeschaltet, müssen Sie alle Wechsel selbst vornehmen.

Die EDITOR-Umgebungsvariable auf „kate -b“ einstellen

  Dies setzt die `EDITOR`-Umgebungsvariable, so dass Programme im eingebauten Terminal, die automatisch eine Datei in einem Editor öffnen, dafür &kate; anstatt des in der Shell definierten Editors verwenden. Sie können das Terminal erst dann weiter benutzen, wenn Sie die in &kate; geöffnete Datei schließen. Bis dahin wartet das aufrufende Programm auf das Ende der Dateibearbeitung.

&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 &eg; `#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.4 (KDE 4.4)

    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 &eg; `#ff0000`.

    current-line-colorSTRING

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

    default-dictionarySTRING

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

  Ab Version: Kate 3.4 (KDE 4.4)

    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 &eg; `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 &eg; `#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 &eg; `#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 KDE4 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 &Tab;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 KDE4 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 &eg; `#ff0000`.

    word-wrapBOOL

  Schaltet den statischen Zeilenumbruch ein und aus.