# 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 &kmenu; oder von der Befehlszeile.

### Vom Startmenü

Öffnen Sie das &kde;-Programmmenü durch Klicken auf den großen K-Knopf links unten auf dem Bildschirm in der Werkzeugleiste. Dies öffnet das Programmmenü. 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

#### Befehlszeilenargumente

&kate; versteht die folgenden Optionen auf der Befehlszeile:

``kate` `--help``

- Zeigt die grundsätzlichen Optionen für die Befehlszeile an.

``kate` `--help-qt``

- Zeigt die &Qt;-Optionen für &kate;

``kate` `--help-kde``

- Zeigt die &kde;-Optionen für &kate;

``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. Wenn die Option `--use` verwendet wurde, dann wird die angegebene Sitzung benutzt.

``kate` `-u` `--use` `URL``

- Mit diese Option wird eine bestehende &kate;-Instanz verwendet, sofern es eine gibt. Dies ist jetzt das Standardverhalten, diese Option existiert nur noch wegen der Kompatibilität.

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

- &kate; benutzt eine existierende Instanz nur dann, wenn diese die angegebene PID (Process ID) hat. Diese Option wird zusammen mit der Option `--use` benutzt.

``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``

- Seit Version 2.5.1 von &kate; wird diese Standardoption von &kde; unterstützt. Sie 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` `--help-all``

- Zeigt alle Möglichkeiten der Befehlszeile an.

``kate` `--author``

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

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

- Zeigt Versionsinformationen für &Qt;, &kde;, und &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 das linke Fenster mit Dateiliste und Dateiauswahlfenster im Menü Ansicht Werkzeugansichten ein- und ausschalten. Dieses Menü bietet Ihnen einen ersten Einblick in &kate;s Leistungsfähigkeit und Flexibilität. In diesem Abschnitt sehen wir uns drei Dinge näher an:

Dokumente anzeigen

- Schaltet die Anzeige der Dokumente ein bzw. aus.

### Tastenkombinationen

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

Einfügen | Umschaltung zwischen Einfüge- und Überschreibmodus. Im Einfügemodus werden alle Zeichen an der Cursor-Position eingefügt und alle Zeichen rechts vom Cursor nach rechts verschoben. Im Überschreibmodus werden die Zeichen rechts vom Cursor sofort durch die neu geschriebenen Zeichen ersetzt.
Pfeil links | Bewegt den Cursor ein Zeichen nach links
Pfeil rechts | Bewegt den Cursor ein Zeichen nach rechts
Pfeil hoch | Bewegt den Cursor um eine Zeile nach oben
Pfeil runter | Bewegt den Cursor um eine Zeile nach unten
Bild auf | Bewegt den Cursor um eine Seite nach oben
Bild ab | Bewegt den Cursor um eine Seite nach unten
&Backspace; | Löscht das Zeichen links vom Cursor
Pos1 | Setzt den Cursor an den Zeilenanfang
Ende | Setzt den Cursor an das Zeilenende
Entf | Löscht das Zeichen rechts vom Cursor (oder den markierten Text)
&Shift;&Enter; | Fügt eine neue Zeile mit allen Zeichen der aktuellen Zeile vom Zeilenanfang bis zum ersten Buchstaben oder bis zur ersten Zahl. Dies kann ⪚ verwendet werden, um Kommentare in einen Quelltext einzufügen. Am Ende der aktuellen Zeile mit dem Inhalt // ein Text// drücken Sie diese Kurzwahl und eine neue Zeile mit // wird eingefügt. Die Kommentarzeichen am Beginn einer neuen Zeile für Kommentare müssen dann nicht mehr zusätzlich eingegeben werden.
&Shift;Pfeil links | Markiert Text ein Zeichen nach links
&Shift;Pfeil rechts | Markiert Text ein Zeichen nach rechts
F1 | Hilfe
&Shift;F1 | Was ist das?
&Ctrl;F | Suchen
F3 | Weitersuchen
&Ctrl;B | Lesezeichen hinzufügen
&Ctrl;C | Kopiert den markierten Text in die Zwischenablage
&Ctrl;N | Neue Datei
&Ctrl;P | Drucken
&Ctrl;Q | Beenden - Aktives Editorfenster schließen
&Ctrl;R | Ersetzen
&Ctrl;S | Speichern der aktuellen Datei im aktuellen Zustand
&Ctrl;V | Einfügen des Inhaltes der Zwischenablage
&Ctrl;X | Markierten Text löschen und in die Zwischenablage kopieren
&Ctrl;Z | Rückgängig
&Ctrl;&Shift;Z | Wiederherstellen

## 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 die Werkzeugfenster benutzt.

- Die Dokumentenliste

- Der Dateisystem-Browser

- Der eingebaute Terminal-Emulator

Und vielleicht noch andere Fenster, die ⪚ durch Erweiterungen bereitgestellt werden können.

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.

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

### Die Dokumentenliste

Die Dokumentenliste zeigt alle aktuell in &kate; geöffneten Dateien an. Dateien, die noch nicht gesicherte Änderungen enthalten, werden mit einem kleinen Disketten-Symbol links neben dem Dateinamen gekennzeichnet.

Als Voreinstellung zeigt die Dokumentenliste eine Baumansicht, die die Ordnerstruktur aller geöffneten Dokumente wiedergibt. Alternativ kann die Listenansicht benutzt werden, die alle geöffneten Dokumente als Liste anzeigt. Zwischen diesen Modi können Sie wechseln, indem Sie mit der &RMBn; auf die Liste klicken und im Kontextmenü einen Ansichtsmodus wählen.

Wenn zwei oder mehrere Dateien mit demselben Namen (in verschiedenen Verzeichnissen) in der Listenansicht geöffnet sind, wird an die Namen eine Zahl angehängt ⪚ (2) &etc; Für die Auswahl der gewünschten Datei wird ihr Name einschließlich Pfad in der Kurzinfo angezeigt.

Wenn Sie ein Dokument aus der Liste aktiv machen wollen, klicken Sie einfach auf den Namen des Dokuments in der Liste.

Sie können die Liste nach verschiedenen Kriterien sortieren, indem Sie mit der rechten Maustaste auf die Liste klicken und im Menü Sortieren nach auswählen. Es stehen folgende Sortierungen zur Auswahl:

Reihenfolge beim Öffnen

- Listet die Dokumente in der Reihenfolge, in der sie geöffnet wurden, auf

Dokument-Name

- Listet die Dokumente in der alphabetischen Reihenfolge des Namens auf.

Dokumentpfad

- Listet die Dokumente in der alphabetischen Reihenfolge des gesamten Pfades zum Dokument auf.

Die Dokumentenliste stellt standardmäßig die Einträge farbig dar: Die Einträge der zuletzt bearbeiteten Dokumente werden mit einer Hintergrundfarbe hervorgehoben, Dokumente, die tatsächlich bearbeitet wurden werden durch eine zusätzliche eingeblendete Farbe hervorgehoben. Das Dokument, das zuletzt bearbeitet wurde, hat die stärkste Farbe, sodass Sie die Dokumente, an denen Sie aktuell arbeiten, einfach finden können. Diese Hervorhebungen können Sie im Einrichtungsdialog auf der Seite Dokumente einstellen.

Die Standardposition der Dokumentliste ist links vom Editorbereich im &kate;-Fenster.

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

### Wiederherstellen des Verhaltens des alten &kate;

Wenn Sie sich erst einmal an Sitzungen gewöhnt haben, dann werden Sie hoffentlich sehen, dass diese ein einfaches und effizientes Werkzeug zum Arbeiten in unterschiedlichen Umgebungen sind. Wenn Sie aber das alte Verhalten von &kate; bevorzugen (alle Dateien werden in einer Instanz geöffnet), dann können Sie dies ganz einfach erreichen, indem Sie:

- Legen Sie fest, dass &kate; immer mit der Option `--use` gestartet wird, indem Sie die Option zum Befehl in den Einstellungen zur Anwendung hinterlegen und zusätzlich erzeugen Sie einen Befehlszeilen-Alias.

- Stellen Sie &kate; so ein, dass beim Starten immer die zuletzt benutzte Sitzung geladen wird.

- Stellen Sie &kate; so ein, dass die Dateiliste gesichert wird, wenn Sie eine Sitzung schließen.

- Laden Sie einmal die Standardsitzung.

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