# Grundsätzliches

&kate; ist sehr einfach zu nutzen. Jeder, der schon einen Texteditor verwendet hat, sollte keine Probleme haben. In den nächsten beiden Abschnitten Starten von &kate; und Arbeiten mit &kate; zeigen wir Ihnen alles, was Sie wissen müssen, um schnell beginnen zu können.

## Starten von &kate;

Starten Sie &kate; vom Anwendungsmenü oder von der Befehlszeile.

### Vom Anwendungsmenü

Öffnen Sie das &kde;-Programmmenü durch Klicken auf das Symbol links unten auf dem Bildschirm in der Kontrollleiste. Dies öffnet das Anwendungsmenü. Zeigen Sie mit der Maus auf den Menüpunkt Dienstprogramme, Editoren. Es erscheint eine Liste der verfügbaren Editoren. Wählen Sie &kate;.

### Von der Befehlszeile

Sie können &kate; auch von der Befehlszeile starten. Wenn Sie dabei gleichzeitig einen Dateinamen angeben, wird diese Datei durch &kate; geöffnet oder erzeugt.

    %kate myfile.txt

Wenn Sie eine aktive Internetverbindung und die erforderlichen Berechtigungen haben, können Sie von den in &kde; eingebauten Netzwerkfähigkeiten profitieren und Dateien direkt im Internet öffnen.

    %kate ftp://ftp.kde.org/pub/kde/README

Als Standard wird der Ordner `/tmp` für temporäre Dateien verwendet. Um diesen Ordner zu ändern, setzen Sie die Umgebungsvariable `TMPDIR` vor dem Start von &kate;, ⪚

    %mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

#### Befehlszeilenargumente

&kate; versteht die folgenden Optionen auf der Befehlszeile:

``kate` `--help``

- Zeigt die Optionen für die Befehlszeile an.

``kate` `-s` `--start` `name``

- Startet Kate mit der Sitzung mit dem Namen: `Name`. Wenn die Sitzung noch nicht existiert, wird sie erzeugt. Wenn diese Sitzung in einer Instanz von &kate; bereits geöffnet ist, dann werden die angegebenen Dateien in diese Instanz geladen.

``kate` `-p` `--pid` `PID``

- &kate; benutzt eine existierende Instanz nur dann, wenn diese die angegebene PID (Process ID) hat.

``kate` `-e` `--encoding` `encoding` `URL``

- Benutzt die angegebene Kodierung für das Dokument.

``kate` `-l` `--line` `line` `URL``

- Setzt den Cursor beim Öffnen des Dokuments auf die angegebene Zeile.

``kate` `-c` `--column` `column` `URL``

- Setzt den Cursor beim Öffnen des Dokuments auf die angegebene Spalte.

``kate` `-i` `--stdin``

- &kate; liest das zu bearbeitende Dokument von der Standardeingabe (STDIN). Dieser Parameter entspricht dem bei Befehlen für die Befehlszeile häufig vorkommenden `-` und erlaubt das Weiterverarbeiten von Programmausgaben in &kate;.

``kate` `--startanon``

- &kate; mit einer neuen, anonymen Sitzung starten. Impliziert `-n`.

``kate` `-n` `--new``

- &kate; in einer neuen Instanz starten. Dies wird ignoriert, wenn `start` benutzt wird und eine andere Instanz von &kate; die angegebene Sitzung geöffnet hat. Wenn keine Parameter oder URLs angegeben sind, wird dieses Verhalten erzwungen.

``kate` `-b` `--block``

- Wenn eine bereits laufende Instanz von &kate; benutzt wird, wird diese blockiert, solange die angegebene URL geöffnet ist.

  Benutzen Sie diese Option, um &kate; als Editor zur Eingabe von Kommentaren für Versionskontrollsysteme wie Git oder Subversion. Diese Systeme erwarten das Blockieren des Editors, bis der Kommentar eingegeben ist. Wenn &kate; sofort zum Aufruf zurückkehren würde, würde die bei diesem Vorgang angelegte temporäre Datei leer sein.

  Diese Option wird auch dann gebraucht, wenn mit KIO (&kde; Input/Output) eine Datei von einem anderen Server geöffnet wird (die in eine temporäre Datei heruntergeladen wurde), die nach dem Sichern wieder hochgeladen werden soll.

``kate` `--tempfile``

- Diese Option gibt an, dass die Dateien als temporäre Dateien behandelt werden sollen und (wenn es lokale Dateien sind und Sie die nötigen Rechte besitzen) beim Schließen gelöscht werden, außer, wenn sie seit dem Öffnen verändert wurden.

``kate` `--desktopfile` `filename``

- Der Basis-Dateiname des Desktop-Eintrags dieser Anwendung.

  Dies ist besonders nützlich für Wrapper-Anwendungen und Anwendungen, die mehrere Desktop-Dateien haben. So kann jede Desktop-Datei ihre eigene Befehlszeile für den Eintrag `Exec` verwenden.

``kate` `--author``

- Dieser Befehl zeigt die Autoren von &kate; im Terminalfenster an.

``kate` `-v` `--version``

- Zeigt Versionsinformationen für &kate; an.

``kate` `--license``

- Zeigt Informationen zu den Lizenzbestimmungen.

### Ziehen und Ablegen (Drag and Drop)

&kate; nutzt das Drag-and-Drop-Protokoll von &kde;. Dateien können gezogen und auf &kate; abgelegt werden; von der Arbeitsoberfläche, &dolphin;, oder einer &FTP;-Seite, die in einem &dolphin;-Fenster geöffnet ist.

## Arbeiten mit &kate;

Schnellstart zeigt Ihnen vier einfache Optionen, die Sie einige leistungsfähigere Funktionen von &kate; sofort nutzen lassen. Tastenkombinationen zeigt einige der Standardtastenkombinationen für diejenigen, die keine Maus benutzen möchten oder können.

### Schnellstart

Dieser Abschnitt beschreibt einige Elemente des Menüs Ansicht, sodass Sie die Funktionen von &kate; schnell in der von Ihnen gewünschten Weise einstellen können.

Wenn Sie &kate; zum ersten Mal starten, sehen Sie zwei Fenster mit weißem Hintergrund. Oberhalb der beiden Fenster ist eine Werkzeugleiste mit den wie üblich bezeichneten Symbolen. Noch darüber sehen Sie eine Menüleiste.

Das linke der beiden Fenster ist eine andockbare Seitenleiste. Diese enthält die Karteikarten Dokumente und Dateisystem-Browser. Die Umschaltung zwischen den beiden erfolgt durch Klicken auf die Karteikartenreiter am linken Rand des Fensters.

Wenn Sie &kate; mit einer Datei geöffnet haben, dann wird diese im rechten Fenster angezeigt und die Karteikarte Dokumente zeigt den Namen der Datei. Sie können den Dateisystem-Browser zum Öffnen von Dateien benutzen.

Sie können alle Seitenleisten im Menü Ansicht Werkzeugansichten ein- und ausschalten oder den Kurzbefehl &Ctrl;&Alt;&Shift;F verwenden. Dieses Menü bietet Ihnen einen ersten Einblick in &kate;s Leistungsfähigkeit und Flexibilität.

In den Werkzeugansichten finden Sie eine Liste aller aktivierten Erweiterungen. Klicken Sie auf das Ankreuzfeld vor jedem Eintrag in der Liste oder klicken Sie mit der &LMBn; auf die Werkzeugknöpfe in der Seitenleiste um die Anzeige dieses Werkzeugs ein- oder auszublenden.

### Tastenkombinationen

Viele von &kate;s Tastenkombinationen sind einstellbar im Menü Einstellungen. Die Standardtastenkombinationen von &kate; sind im folgenden beschrieben:

F1 | Hilfe
&Shift;F1 | Was ist das?
&Ctrl;N | Neue Datei
&Ctrl;L | Alles speichern
&Ctrl;O | Ein Dokument öffnen
&Ctrl;&Alt;O | Schnellöffner
&Ctrl;&Shift;F | Vollbildmodus
&Ctrl;&Shift;, | &kate; einrichten
&Ctrl;W / &Ctrl;&Esc; | Schließen
&Ctrl;Q | Beenden - Aktives Editorfenster schließen
&Ctrl;&Alt;&Shift;F | Navigationsbereich anzeigen
&Ctrl;&Shift;T | Waagerecht teilen
&Ctrl;&Shift;L | Senkrecht teilen
F8 | Nächste Teilansicht
&Shift;F8 / &Ctrl;&Esc; | Vorherige Teilansicht
&Ctrl;&Shift;R | Aktuelle Ansicht schließen
&Alt;&Right; | Nächstes Unterfenster
&Alt;&Left; | Vorheriges Unterfenster

Zusätzlich können Sie die Kurzbefehle der &katepart;-Komponente und aller aktiven &kate;-Module verwenden.

## Arbeiten mit dem MDI (MultiDokumentInterface) von &kate;

### Überblick

Fenster, Ansicht, Dokument, Rahmen, Editor ... Was ist dies alles in der Terminologie von &kate; und wie können Sie diese am besten nutzen? Dieses Kapitel erklärt all dies und mehr.

#### Das Hauptfenster

Das Hauptfenster von &kate; ist ein Standard-&kde;-Anwendungsfenster mit einer zusätzlichen Seitenleiste, die Werkzeugansichten enthält. Es hat eine Menüleiste mit den Standardmenüs und einigen mehr, sowie eine Werkzeugleiste mit Knöpfen für oft benutzte Befehle.

Der wichtigste Teil des Fensters ist der Editorbereich, der standardmäßig einen Texteditor anzeigt, in dem Sie Ihr Dokument bearbeiten können.

Die Ankoppelfähigkeit des Hauptfensters wird für alle Werkzeugfenster benutzt, die im Einrichtungsdialog aktiviert wurden.

Werkzeugansichten können in jeder Seitenleiste positioniert werden. Zum Verschieben eines Werkzeugs klicken Sie mit der &RMBn; auf dessen Seitenleistenknopf und wählen Sie im Kontextmenü aus.

Eine Werkzeugansicht kann als bleibend im Kontextmenü des zugehörigen Seitenleistenknopfes markiert werden. Die Seitenleiste kann mehrere Werkzeuge zur gleichen Zeit enthalten, sodass, wenn ein Werkzeug bleibend markiert ist, auch andere Werkzeuge gleichzeitig angezeigt werden können.

Gibt es für eine Erweiterung Einstellungsoptionen, können Sie den ersten Eintrag im Kontextmenü benutzen, um die zugehörige Seite im Einrichtungsdialog von &kate; zu öffnen.

### Der Editorbereich

&kate; kann mehrere Dokumente zur gleichen Zeit offen haben und kann den Editorbereich in beliebig viele Rahmen teilen, ähnlich wie dies beim &konqueror; oder in emacs möglich ist. Auf diese Weise können Sie mehrere Dokumente oder ein Dokument in mehreren Ansichten gleichzeitig sehen, sehr hilfreich, ⪚ wenn Ihr Quelltext ganz am Anfang Definitionen enthält, die Sie beim Arbeiten immer wieder brauchen oder Sie zeigen einen Header eines Quellprogrammes in einem Rahmen an und schreiben die Implementation in einem anderen.

Wenn ein Dokument in mehr als einem Rahmen geöffnet ist, dann wirken sich Änderungen sofort in allen Rahmen mit diesem Dokument aus. Das gilt sowohl für Änderungen im Text als auch für das Auswählen von Text. Suchoperationen oder Cursor-Bewegungen dagegen wirken sich nur auf das aktuelle Fenster aus.

Es ist nicht möglich, mehrere Fenster desselben Dokuments zu öffnen in dem Sinne, dass ein Fenster geändert wird und ein anderes nicht.

Wenn das Editorfenster in zwei Teile geteilt wird, werden zwei gleich große Rahmen erstellt, in beiden wird das vorher aktuelle Dokument angezeigt. Der neue Rahmen wird unten oder rechts geöffnet und bekommt den Fokus, was durch den blinkenden Cursor in diesem Rahmen angezeigt wird.

## Benutzen von Sitzungen

Sitzungen erlauben Ihnen mehrere Listen von Dokumenten und Einstellungen für das Benutzen in &kate; zu speichernd. Sie können beliebig viele Sitzungen speichern, und Sie können unbenannte oder anonyme Sitzungen für das einmalige Bearbeiten von nur Dokumenten verwenden. Derzeit kann &kate; die Liste der geöffneten Dokumente und die grundlegenden Fenstereinstellungen in der Sitzung speichern, zukünftige Versionen von &kate; werden weitere Parameter speichern können. Mit der Einführung von Sitzungen können Sie auch so viele Instanzen von &kate; öffnen wie Sie wollen, anstelle der bisher standardmäßig nur einen Instanz.

Sitzungen werden in drei Bereichen unterstützt:

- Befehlszeilenoptionen die Sie Sitzungen auswählen und starten lassen, wenn Sie &kate; von der Befehlszeile aufrufen.

- Das Menü Sitzungen in dem Sie Sitzungen umschalten, sichern, starten und verwalten können.

- Einstellungsoptionen die festlegen, wie Sitzungen standardmäßig arbeiten sollten.

Wenn Sie eine neue Sitzung starten, dann wird das Dialogfenster für die Standardsitzung geöffnet. Zum Speichern der Fenstereinstellungen in der Standardsitzung müssen Sie das Feld Fenstereinstellungen einbeziehen auf der Karte Sitzungsverwaltung unter Einstellungen - Kate einrichten... einschalten, dann die Standardsitzung laden, die Fenstereinstellungen anpassen und die Sitzung speichern.

Wenn eine mit Namen bezeichnete Sitzung geladen wird, dann zeigt &kate; den Sitzungsnamen am Anfang des Fenstertitels an, der dann die Form "`Sitzungsname`: `Dokumentname oder &URL;` - &kate;" hat.

Wenn Dateien unter Verwendung der Option `--start `Name`` geöffnet werden oder wenn eine Sitzung in der Sitzungsverwaltung ausgewählt wurde, dann wird die angegebene Sitzung vor den angegebenen Dateien geladen. Wenn Sie Dateien in einer neuen, unbenannten Sitzung öffnen wollen, dann müssen Sie unter Einstellungen - Kate einrichten... auf der Karte Sitzungsverwaltung das Verhalten beim Programmstart auf Neue Sitzung starten einstellen oder den Parameter `--start` mit einer leeren Zeichenkette: `''` in der Befehlszeile angeben.

Seit Version 2.5.1 von &kate; wird die PID der aktuellen Instanz in die Umgebungsvariable `KATE_PID` exportiert. Wenn Dateien von der eingebauten Befehlszeile aus geöffnet werden, dann verwendet Kate dazu automatisch die aktuelle Instanz, wenn auf der Befehlszeile nichts anderes angegeben wurde.

## Hilfe anfordern

### Mit &kate;

Dieses Handbuch

- Dieses Handbuch enthält detaillierte Informationen zu allen Menübefehlen, Einstellungen in der Konfiguration von &kate;, Dialogen, Modulen &etc; sowie Beschreibungen des &kate;-Fensters, des Editors und verschiedener Konzepte, die in &kate; verwendet werden.

  Drücken Sie die Taste F1 oder nutzen Sie den Menübefehl Hilfe Handbuch zu &kate; zur Anzeige des Handbuchs.

Was ist das?-Hilfe

- Was ist das? stellt Soforthilfe zu einzelnen Elementen der Fenster bereit, wie ⪚ Knöpfe oder Fensterbereiche.

  Wir versuchen, zu allen Elementen, wo dies sinnvoll ist, die Hilfe in der Was ist das?-Form bereitzustellen. Die Hilfe ist im Einstellungen-Dialog und in vielen andere Dialogen verfügbar.

  Zum Aufrufen der Was ist das?-Hilfe drücken Sie die Tastenkombination &Shift;F1 oder nutzen Sie den Menübefehl Hilfe Was ist das? . Der Cursor verwandelt sich in einen Pfeil mit Fragezeichen und jetzt können Sie auf ein Element im Fenster klicken und erhalten die Hilfe zu diesem Element, sofern vorhanden.

Hilfe-Knöpfe in Dialogen

- Einige Dialoge enthalten einen Hilfe-Knopf. Klicken auf diesen öffnet das &kde;-Hilfezentrum mit der zum Dialog zugeordneten Information.

### Mit Ihren Textdateien

&kate; enthält (noch) keine Funktionen zum Lesen von Dokumentation, die zu der bearbeiteten Datei Hilfestellung gibt. Abhängig von der bearbeiteten Datei kann Ihnen der Terminal-Emulator hilfreich für das Lesen von &UNIX;-Handbuchseiten oder Info-Dokumentation sein oder Sie können dazu den &konqueror; benutzen.

### Artikel über &kate;

Die Webseite zu &kate; stellt einige Artikel und Anleitungen mit weiteren Informationen bereit, die den Umfang dieses Handbuchs sprengen würden.