# Arbeiten mit Erweiterungen

In &kate; sind mehrere Erweiterungen enthalten. Es gibt zwei Arten von Modulen: Module können in nativem C++ oder in Python geschrieben werden. Zwischen diesen gibt es Unterschiede, die anschließend beschrieben werden.

Im Einrichtungsdialog können Sie alle Arten von Erweiterungen auswählen. Hier finden Sie auch die Einstellungen für einzelne Erweiterungen, bei denen das nötig ist.

## &kate;-Programmerweiterungen

&kate;-Programmerweiterungen enthalten zusätzliche Funktionen für den Editor &kate;. Diese Erweiterungen können zusätzliche Menüs und Kurzbefehle einfügen und erweitern die Fähigkeiten von &kate;. Sie können eine beliebige Anzahl von Erweiterungen in einem geöffneten &kate;- Programm installieren. Öffnen Sie den Einrichtungsdialog für &kate; mit Einstellungen&kate; einrichten ... und wählen Sie unter Programm Erweiterungen die gewünschten Erweiterungen aus.

Folgende Programmerweiterungen sind verfügbar:

- Backtrace-Browser - Ansicht zur Navigation in C/C++ Backtraces

- Erstellen-Modul - Kompilieren oder Make aufrufen und Fehlermeldungen ausgeben

- Bedingtes Schließen - Eine Gruppe von Dokumenten auf der Basis eines gemeinsamen Pfades oder einer Dateierweiterung schließen

- CTags - Definition/Deklaration mit CTags nachschauen

- Dokumentvorschau - Vorschau des Dokuments im Zielformat.

- Dokumentumschalter - Schnellwechsler für Dokumente mit &Alt;

- Dateisystem-Browser - Werkzeugansicht für Dateisystem-Browser

- Dokumentbaum - Zeigt geöffnete Dokumente als Baumansicht an

- &gdb; - Stellt eine einfache &gdb;-Oberfläche zur Verfügung.

- Header öffnen - Öffnet die zusammengehörigen .h/[.cpp|.c]-Dateien

- Projekterweiterung - Integration von Git und anderen Versionsverwaltungen für Quelltexte

- Replicode - eine konstruktivistische KI-Programmiersprache und Laufzeitumgebung

- LSP-Client - Modul für Quelltextnavigation und -Vervollständigung für viele Sprachen

- Suchen und Ersetzen - Suchen und Ersetzen in Dokumenten, Ordnern oder Projekten

- Werkzeugansicht für Textbausteine - Werkzeugansicht für die eingebettete Verwaltung von Textbausteinen

- SQL-Erweiterung - Anfragen an SQL-Datenbanken ausführen

- Symbolbetrachter - Referenzsymbole aus Quelldateien extrahieren und anzeigen

- Werkzeugansicht für Terminal - Werkzeugansicht, die Konsole als Terminal einbettet

- Textfilter - Bearbeitung von Text mit Terminal-Befehlen

- &XML;-Vervollständigung - Zeigt &XML;-Elemente, Attribute, Attributwerte und Entitäten an, die von der DTD definiert werden

- &XML;-Überprüfung - Überprüft &XML;-Dateien mit xmllint

## Backtrace-Browsermodul

### Das Backtrace-Browsermodul benutzen

Dieses Modul ist für Entwickler gedacht und wahrscheinlich von geringem Nutzen für Anwender. Es zeigt einen von `gdb` gelieferten Backtrace in einer Liste in einer &kate;-Werkzeugansicht. Klicken auf ein Element öffnet die ausgewählte Datei und springt zur richtigen Zeilennummer. Es funktioniert für Backtraces, die auf Ihrem eigenen Rechner erzeugt wurden, aber auch für Backtraces von Anderen, &ie; `/home/dummy/qt-copy/.../qwidget.cpp` wird weiterhin auf anderen Rechnern gefunden. Dafür müssen Sie die Ordner mit dem Quelltext indizieren.

Manchmal gibt es mehrere Dateien mit dem gleichen Namen wie ⪚:

- `kdegraphics/okular/generators/dvi/config.h`
- `kdepim-runtime/resources/gmail/saslplugin/config.h`

Um die richtige Auswahl zu treffen, werden die letzten beiden Teile der &URL; verwendet, in diesem Fall:

- `dvi/config.h`
- `saslplugin/config.h`

Dann wird normalerweise die richtige Datei gefunden.

Wenn Sie aber sowohl „master“ als auch einen Branch indizieren, gibt es eine Kollision.

### Einstellungen

Fügen Sie auf der Einstellungsseite die Ordner mit dem Quelltext hinzu.

Backtrace-Browser
Einrichtung von Pfaden in der Ansicht des Backtrace-Browser

Klicken Sie auf OK, um die Indizierung zu starten. Ist die Indizierung beendet, öffnen die Ansicht des Backtrace-Browser.

Nun können Sie einen Backtrace aus der Zwischenablage laden, wenn Sie ⪚ in DrKonqi auf In Zwischenablage kopieren gedrückt haben oder Sie laden einen Backtrace aus einer Datei.

## Erstellen-Modul

### Einleitung

Mit dem Erstellen-Modul können Sie ein Projekt erstellen, dessen Konfiguration zurücksetzen und es kompilieren.

### Das Erstellen-Modul benutzen

Aktivieren Sie das Erstellen-Modul, dann wird eine Anzeige für die Ausgabe beim Erstellen unten im Fenster und ein Menü Erstellen in der Menüleiste eingefügt. Mit der Ausgabe beim Erstellen können Sie Einstellungen der Ziele angeben und im Menü Aktionen zum Erstellen, Aufräumen und Kompilieren aufrufen.

Ausgabe beim Erstellen

Die Ausgabe beim Erstellen zeigt zwei Karteikarten an:

- Ziel-Einstellungen

- Ausgabe

#### Die Karteikarte „Ziel-Einstellungen“

Auf dieser Karteikante können Sie mehrere Ziele für das Erstellen und Zielgruppen angeben.

Um Namen oder Befehle zu ändern, doppelklicken Sie auf die Einträge in der Tabelle und verwenden das Auswahlfeld, um die aktive Zielgruppe auszuwählen. Benutzen Sie das Ankreuzfeld vor jedem Ziel, um die Voreinstellung festzulegen.

Für ein neues Ziel gibt es mehrere Einstellungsmöglichkeiten:

Arbeitsordner

- Hier können Sie den Pfad für das Projekt eintragen. Wenn Sie dieses Feld leer lassen wird der Ordner verwendet, in dem die aktuelle Datei gespeichert ist.

Erstellen

- Mit dieser Einstellung legen Sie den Befehl zum Erstellen fest. Die Voreinstellung ist `make`.

Aufräumen

- Mit dieser Einstellung legen Sie den Befehl zum Löschen der Konfiguration fest. Die Voreinstellung ist `make clean`.

Einstellungen

- Mit dieser Einstellung legen Sie den Befehl zur Konfiguration fest. Die Voreinstellung ist `cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../`.

Oben in diesem Modul gibt es eine Werkzeugleiste mit folgenden Knöpfen:

- Ausgewähltes Ziel erstellen
- Neues Ziel hinzufügen
- Neue Zielgruppe erstellen
- Befehl oder Zielgruppe kopieren
- Aktuelle Zielgruppe löschen

#### Die Karteikarte „Ausgabe“

Die Karteikarte Ausgabe zeigt die Konsolenausgabe des letzten Befehls an.

Mit den Schieberegler oben können Sie Kategorien für die Ausgabe aus- oder einblenden:

Vollständige Ausgabe, Verarbeitete Ausgabe, Fehler und Warnungen oder Nur Fehler

Jede Zeile enthält eine Nachricht mit dem Namen der Datei und - wenn vorhanden - mit der Zeilennummer Klicken Sie auf eine Zeile mit Fehlern oder Warnungen, dann wird die zugehörige Datei geöffnet und der Cursor auf die angegebene Zeilennummer gesetzt..

Zum vorherigen Fehler gehen Sie mit &Alt;&Shift;&Left;, zum nächsten Fehler mit &Alt;&Shift;&Right;.

### Menüstruktur

Erstellen Ziel auswählen

- Ermöglicht die Auswahl aus einer Liste von benutzerdefinierten Zielen.

Erstellen Standardziel erstellen

- Erstellt das als Voreinstellung definierte Ziel in der aktiven Zielgruppe.

Erstellen Vorheriges Ziel erstellen

- Wechselt zum vorherigen vom Benutzer definierten Ziel.

Erstellen Anhalten

- Hält das Erstellen eines Ziels an.

&Ctrl;&Alt;Pfeil links Erstellen Vorheriger Fehler

- Verschiebt den Cursor zum vorherigen Fehler im Dokument.

&Ctrl;&Alt;Pfeil rechts Erstellen Nächster Fehler

- Verschiebt den Cursor zum nächsten Fehler im Dokument.

### Danksagungen

Das Erstellen-Modul für &kate; wurde von Kåre Särs geschrieben.

Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Salma Sultana,der den Hauptteil diese Abschnitts geschrieben hat.

## Modul zum bedingten Schließen

### Einleitung

Mit diesem Modul können Sie eine Gruppe von Dokumenten anhand ihrer Dateierweiterungen und Pfade schließen.

### Das Modul zum bedingten Schließen benutzen

Angenommen Sie haben folgende Dokumente in &kate; geöffnet:

- /tmp/subfolder/test.h
- /tmp/test.cpp
- /tmp/test.txt

Wie im folgenden Bildschirmfoto gezeigt wird, gibt es dann folgende Möglichkeiten zum Schließen von Dokumenten.

Schließen außer

Verwenden Sie das Ankreuzfeld im letzten Eintrag der Liste, um einen Bestätigungsdialog zu aktivieren oder zu deaktivieren. Die gewählte Einstellung wird auf beide Aktionen zum Schließen angewendet.

### Menüstruktur

Datei Schließen außer

- Schließt alle offenen Dokumente, außer denen, auf die der Pfad oder die Dateierweiterung passt, die im Untermenü ausgewählt wurde.

Datei Schließen ähnlich

- Schließt alle offenen Dokumente, auf die der Pfad oder die Dateierweiterung passt, die im Untermenü ausgewählt wurde.

## CTags-Modul

### Einleitung

CTags generiert eine Datei mit Indizes oder Tags von allen Sprachobjekten in Quelltexten. In &kate; können Sie mit diesem Modul diese Einträge schnell und einfach finden.

Ein Tag kennzeichnet ein Sprachobjekt, für das eine Indexeintrag verfügbar oder alternativ erstellt wird.

Die Generation von Tags wird für diese Programmiersprachen unterstützt.

### Einstellungen

Das Modul CTags verwendet zwei verschiedene Datenbankdateien für den Index.

Auf dieser Einstellungsseite für CTags im Einrichtungsdialog von &kate; können Sie Ordner mit dem Quelltext hinzufügen oder entfernen und die allgemeine CTags-Datenbank neu erstellen.

#### Allgemeiner Index

CTags-Einstellungen
Globale Datenbank für CTags einrichten

Unten auf der Einstellungsseite können Sie den CTags-Befehl anpassen.

Weitere Informationen über alle verfügbaren Optionen finden Sie im Handbuch zu CTags n &khelpcenter; oder geben Sie die &URL; man/:ctags in &konqueror; ein.

Klicken Sie auf Aktualisieren, um die Indizierung zu starten. Ist die Indizierung beendet, schließen Sie den Dialog,

#### Sitzungs-Index

Um den Sitzungsindex einzurichten, öffnen Sie die Ansicht CTags.

Ziele indizieren

- Auf dieser Karteikarte können Sie Ordner mit dem Quelltext hinzufügen oder entfernen und die sitzungsspezifische CTags-Datenbank neu erstellen.

Datenbank

- Datenbankeinstellungen
  Sitzungs-Datenbank für CTags einrichten

  Wählen Sie eine andere CTags-Datenbankdatei, richten Sie den CTags-Befehl ein oder stellen Sie den Standardbefehl wieder her.

### Das CTags-Modul benutzen

Setzen Sie den Cursor in ein Sprachobjekt wie eine Funktion, Symbol &etc; und verwenden Sie dann die Aktionen im Menü CTags, um zur Datei und Zeile mit der Deklaration oder Definition des Objekts zu springen.

Als Voreinstellung sind den Aktionen im Menü CTags keine Kurzbefehle zugewiesen. Benutzen Sie den Dialog Kurzbefehle festlegen, um eigene Kurzbefehle zu definieren.

Alternativ können Sie das Suchfeld auf der Karteikarte Nachschlagen in der CTags-Ansicht verwenden.

Mit der Eingabe von Zeichen in das Suchfeld wird die Suche gestartet und passende Sprachobjekte wie Funktionen, Klassen, Symbolen &etc; zusammen mit Typ und Dateinamen angezeigt.

Wählen Sie ein Element in der Liste, um zu der zugehörigen Zeile in der Quelltextdatei zu springen.

### Menüstruktur

CTags Einen Schritt zurückgehen

- Geht im Verlauf zu dem zuletzt angezeigten Tag zurück.

CTags Aktuellen Text suchen

- Öffnet die Karteikarte Nachschlagen in der CTags-Ansicht und zeigt alle Sprachobjekte in einer Liste, die zur aktuellen Textauswahl passen.

CTags Zur Deklaration gehen

- Befindet sich der Cursor in einer Objektdefinition, wird mit dieser Aktion das Dokument geöffnet, das die Deklaration enthält, falls erforderlich, zur Ansicht gewechselt und der Cursor an den Anfang der Deklaration gesetzt.

CTags Zur Definition gehen

- Befindet sich der Cursor in einer Objektdeklaration, wird mit dieser Aktion das Dokument geöffnet, das die Definition enthält, falls erforderlich, zur Ansicht gewechselt und der Cursor an den Anfang der Definition gesetzt.

## Dokumentvorschau-Modul

### Einleitung

Diese Modul ermöglicht eine Live-Vorschau des aktuell bearbeiteten Textdokuments im endgültigen Format in der Seitenleiste. Wenn Sie ⪚ einen Markdown-Text oder ein SVG-Bild bearbeiten, wird das Ergebnis sofort neben dem Quelltext angezeigt.

Für die Anzeige wird das KParts-Modul verwendet, das für den &MIME;-Typ des Dokuments als bevorzugtes Modul eingestellt ist. Gibt es für diesen Typ kein KParts-Modul, ist eine Anzeige nicht möglich.

Um das bevorzugte Modul zu ändern, öffnen Sie das Modul Dateizuordnungen in den &systemsettings; und ändern die Rangfolge der zugeordneten Dienstprogramme auf der Karteikarte Einbetten.

### Einige verfügbare KParts-Module

&MIME;-Typ | KParts-Modul
Markdown-Text | KMarkdownWebViewPart oder OkularPart
SVG-Grafik | SVGPart
&Qt;-UI-Dateien | KUIViewerPart
Dot-Graphendateien | KGraphViewerPart

### Menüstruktur

Ansicht Werkzeugansichten Vorschau anzeigen

- Schaltet die Anzeige der Dokumentvorschau in der Seitenleiste ein und aus.

### Oberfläche

Mit den Knöpfen oben im Vorschaufenster können Sie folgende Aktionen ausführen:

- Beschränken Sie die Vorschau auf ein bestimmtes Dokument. Durch die Auswahl dieser Option wird beim Wechseln zur Ansicht eines anderen Dokuments im selben &kate;-Fenster ,die Vorschau nicht auf dieses Dokument angezeigt, sondern die Vorschau dieses Dokuments.

- Die automatische Aktualisierung der Vorschau des Inhalts des aktuellen Dokuments ein- oder ausschalten

- Die Vorschau des Inhalts des aktuellen Dokuments manuell aktualisieren

- Ein Aufklappmemü mit Aktionen des KParts-Moduls

## Dokumentumschalter-Modul

### Menüstruktur

&Ctrl; Ansicht Zuletzt verwendete Ansichten

&Ctrl;&Shift; Ansicht Zuletzt verwendete Ansichten (rückwärts)

- Öffnet eine Liste mit den zuletzt angesehenen Dokumenten:

  Zuletzt angesehene Dokumente

  Halten Sie die &Ctrl;-Taste gedrückt und verwenden Sie die -Taste, um vorwärts durch die Listenansicht zu blättern. Drücken Sie zusätzlich die &Shift;taste, um die Richtung umzudrehen.

  Halten Sie die Tasten &Ctrl; gedrückt, dann können Sie mit den Tasten &Up;, &Down;, &Home; oder &End; in der Liste navigieren. Drücken Sie fortlaufend eine Zeichentaste, um durch alle Einträge mit diesem Zeichen an Anfang des Dateinamens zu gehen. Lassen Sie die Tasten los, wechselt die Ansicht zum ausgewählten Dokument in der Liste.

## Der Dateisystem-Browser

Der Dateisystem-Browser ist ein Ordneranzeige, in der Sie Dateien im aktuell angezeigten Ordner öffnen können.

### Menüstruktur

Ansicht Werkzeugansichten Dateisystem-Browser anzeigen

- Schaltet die Anzeige des Dateisystem-Browsers von &kate; ein und aus.

### Oberfläche

Von oben nach unten besteht der Dateisystem-Browser aus folgenden Elementen:

Eine Werkzeugleiste

- Diese enthält Standardnavigationsknöpfe:

  Zurück

- Drücken dieses Knopfes schaltet die Anzeige zu dem vorher angezeigtem Verzeichnis in der Verlaufsliste um. Wenn es keine Eintragung in der Liste gibt, ist dieser Knopf deaktiviert.

Vorwärts

- Drücken dieses Knopfes schaltet die Anzeige zu dem nächsten Verzeichnis in der Verlaufsliste um. Wenn es keine nächste Eintragung in der Liste gibt, ist dieser Knopf deaktiviert.

Lesezeichen

- Öffnet ein Untermenü zum Ändern oder Hinzufügen von Lesezeichen. Hier können Sie auch ein neues Lesezeichenverzeichnis hinzufügen.

Aktueller Dokumentordner

- Drücken dieses Knopfes schaltet die Anzeige zu dem Verzeichnis des aktuellen Dokuments im Editorfenster um. Dieser Knopf ist deaktiviert, wenn das aktive Dokument neu und ungesichert ist oder wenn nicht entschieden werden kann, aus welchem Ordner die Datei stammt.

Optionen

- Kurzansicht

- Zeigt nur die Namen der Dateien.

Ausführliche Ansicht

- Zeigt Name, Datum und Größe der Dateien an.

Baumansicht

- Wie die Kurzansicht, aber die Ordner können ein- und ausgeklappt werden, um die Unterordner oder Dateien darin anzuzeigen.

Ausführliche Baumansicht

- In dieser Ansicht können die Ordner ebenfalls ein- und ausgeklappt werden, zusätzlich werden die Spalten wie in der Ausführlichen Ansicht angezeigt.

Versteckte Dateien anzeigen

- Zeigt auch die normalerweise ausgeblendeten Dateien des Betriebssystems an.

Automatisch mit dem aktuellen Dokument abgleichen

- Ist diese Einstellung aktiviert, wechselt der Dateisystem-Browser automatisch mit dem Befehl `cd` in den Ordner des aktuell geöffneten Dokuments im Editorbereich, wenn das aktuell geöffnete Dokument gewechselt wird.

Eine Adressleiste

- Die Adressleiste zeigt den Pfad zum aktuell geöffneten Ordner als Verknüpfungsansicht wie zum Beispiel in &dolphin;. Klicken Sie auf einen Ordner in dieser Ansicht, um ihn zu öffnen, oder Klicken Sie auf einen der Pfeile, um einen Unterordner in dem Ordner zu öffnen. Mit dem ersten Pfeil öffnen Sie den Basisordner Ihres Dateiverzeichnisses.

  Klicken Sie rechts in der Verknüpfungsansicht, dann können Sie direkt den Pfad des Verzeichnisses angeben, das angezeigt werden soll. Dieses &URL;-Feld unterhält eine Liste von vorher eingegebenen Verzeichnissen, die durch Klick auf den kleinen Pfeil rechts aufgerufen werden kann.

  Das &URL;-Feld hat eine automatische Vervollständigung, die Vervollständigungsmethode kann durch das mit der rechten Maustaste aufzurufende Kontextmenü eingestellt werden.

Eine Ordneransicht

- Dies ist eine Standard-&kde;-Ordneransicht.

Ein Filtereintrag

- Der Filtereintrag gestattet die Verwendung von Filtern für die Verzeichnisansicht. Der Filter benutzt Standardausdrücke, die einzelnen Einträge müssen durch Leerzeichen getrennt sein. Beispiel: `*.cpp *.h *.moc`

  Um alle Dateien anzuzeigen, geben Sie einen einzelnen Stern (`*`) ein.

  Der Filtereintrag speichert die letzten zehn benutzten Filter. Um darauf zuzugreifen, klicken Sie auf den kleinen Pfeil rechts im Filtereintrag. Um das Filtern auszuschalten, klicken Sie auf das Symbol Text löschen links neben dem Pfeil für die automatische Vervollständigung.

### Einstellungen

Die Einstellungen für diese Erweiterung finden Sie auf der Seite Dateisystem-Browser in &kate;s Einrichtungsdialog.

Werkzeugleiste

- Hier können Sie festlegen, welche Knöpfe die Werkzeugleiste Dateisystem-Browser enthalten soll, indem Sie diese mit den Pfeilknöpfen in der Mitte in den Bereich Ausgewählte Aktionen: befördern (oder daraus). Sie können die ausgewählten Aktionen dann mit den Knöpfen rechts ordnen.

## Die Dokumentenliste

### Einleitung

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.

Oben in der Dokumentenliste gibt es eine Werkzeugleiste mit folgenden Knöpfen:

- Neues Dokument erstellen
- Ein existierendes Dokument öffnen
- Vorheriges Dokument
- Nächstes Dokument
- Speichert das aktuelle Dokument
- Speichert das aktuelle Dokument unter einem neuen Namen

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.

Im Kontextmenü finden Sie einige Aktionen aus dem Menü Datei.

Außerdem gibt es Aktionen zur Dateiverwaltung wie Umbenennen oder Löschen von Dateien. Mit Dateipfad kopieren können Sie den vollständigen Pfad eines Dokuments in die Zwischenablage kopieren.

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:

Dokumentname

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

Dokumentpfad

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

Reihenfolge beim Öffnen

- Listet die Dokumente in der Reihenfolge, in der sie geöffnet wurden, 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.

### Menüstruktur

&Alt;&Up; Ansicht Vorheriges Dokument

- Zeigt das Dokument über dem aktuell geöffneten Dokument in der Dokumentenliste an.

&Alt;&Down; Ansicht Nächstes Dokument

- Zeigt das Dokument unter dem aktuell geöffneten Dokument in der Dokumentenliste an.

Ansicht Aktive anzeigen

- Zeigt das aktuell geöffnete Dokument in der Dokumentenliste.

### Einstellungen

Hintergrundeinfärbung

- In diesem Abschnitt können Sie die Hintergrundeinfärbung der zuletzt angezeigten Dokumente ein- oder ausschalten und die Farben für die Einfärbung einstellen.

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.

## &gdb;-Erweiterung

### Einleitung

&kate;s &gdb;-Erweiterung stellt eine einfache Oberfläche für den Debugger des &GNU;-Projekts zur Verfügung.

Erfahrung im Umgang mit &gdb; wird für diese Erweiterung dringend empfohlen. Weitere Informationen über die Anwendung von &gdb; finden Sie auf der &gdb;-Webseite.

Sie können die &gdb;-Erweiterung im Abschnitt Erweiterungen des Einrichtungsdialogs von &kate; aktivieren.

Damit die Erweiterung richtig funktioniert, brauchen Sie eine Quelltextdatei, deren Typ von &gdb; unterstützt wird, und die ausführbare Programmdatei.

Wenn Sie den Compiler &gcc;/`g++` verwenden, benötigen Sie das Befehlszeilenargument ``-ggdb``.

Nach diesen Vorbereitungen öffnen Sie die Quelltextdatei in &kate;, geben den Pfad zum ausführbaren Programm auf der Karteikarte Einstellungen der Debug-Ansicht ein und wählen zum Start Debuggen Debuggen starten aus dem Menü.

### Menü- und Werkzeugleistenstruktur

Alle Aktionen finden Sie in &kate;s Menüs, viele dieser Aktionen auch in der Werkzeugleiste GDB-Erweiterung.

Ansicht Werkzeugansichten Debug-Ansicht anzeigen

- Zeigt eine Werkzeugansicht mit der &gdb;-Ausgabe, einer &gdb;-Befehlszeile und weiteren Einstellungen.

Ansicht Werkzeugansichten Lokale Variablen und Aufrufstapel anzeigen

- Zeigt eine Liste aller aktuell geladenen Variablen und deren Werte und eine &gdb;-Rückverfolgung.

Debuggen Ziele

- Ein Untermenü mit einer Liste von Zielen (ausführbaren Programmen).

Debuggen Debuggen starten

- Startet &gdb; mit einem Ziel.

Debuggen Debuggen beenden/abbrechen

- Beendet &gdb;.

Debuggen Debuggen neustarten

- Startet &gdb; erneut.

Debuggen Haltepunkt ein-/ausschalten

- Setzt einen Haltepunkt an der aktuellen Cursor-Position.

Debuggen Einzelschritt

- Führt die aktuelle Anweisung aus und untersucht die Funktion.

Debuggen Funktionsschritt

- Führt die aktuelle Anweisung aus und überspringt die Funktion.

Debuggen Ausführen bis Rücksprung

- Startet die Ausführung des Programms wieder bis zum Ende der Programmausführung.

Debuggen Programmzähler verschieben

- Verschiebt den Programmzähler zur nächsten Ausführung.

Debuggen Bis zum Cursor ausführen

- Führt das Programm bis zur aktuellen Cursor-Position aus.

Debug Fortsetzen

- Ignoriert alle Haltepunkte und führt das Programm bis zum erfolgreichen Ende oder zum Absturz aus.

Debuggen Wert anzeigen

- Gibt den Wert der Variablen unter der aktuellen Cursor-Position.

Einstellungen Angezeigte Werkzeugansichten &gdb;-Erweiterung

- Blendet die Werkzeugleiste der GDB-Erweiterung ein oder aus.

### Debug-Ansicht

Die Debug-Ansicht besteht aus mehreren Karteikarten:

&gdb;-Ausgabe

- Enthält die Ausgaben von &gdb; und eine &gdb;-Befehlszeile.

  Die Karteikarte „GDB-Ausgabe“ Die Karteikarte „GDB-Ausgabe“

  Die Karteikarte GDB-Ausgabe zeigt die Ausgabe einer Debuggersitzung an.

Einstellungen

- Ausführbare Datei

- Pfad zum Ziel (ausführbares Programm) zum Debuggen.

Arbeitsordner

- Der aktuelle Arbeitsordner des Ziels.

Argumente

- Argumente, die an das Programm übergeben werden.

Aktiviert halten

- Behält den Fokus auf der &gdb;-Befehlszeile.

E/A umleiten

- Öffnet eine neue Karteikarte E/A in der Debug-Ansicht, die die Ausgabe des laufenden Programms zeigt und Eingaben für das Programm ermöglicht.

Der Einrichtungsdialog Der Einrichtungsdialog

Der Dialog Einstellungen zeigt die Einstellungen einer Debuggersitzung an.

E/A

- Enthält eine Karteikarte für die Ausgabe des laufenden Programms und eine Befehlszeile für Eingaben zum Programm.

  Die Karteikarte „E/A“ Die Karteikarte „E/A“

  Die Karteikarte E/A mit der Ausgabe eines einfachen Testprogramms.

### Aufrufstapel und lokale Variablen

Die Ansicht Aufrufstapel enthält einen formatierten Backtrace (Rückverfolgung), der von &gdb; ausgegeben wurde.

Die Ansicht des &gdb;-Aufrufstapels Die Ansicht des Aufrufstapels.

Die Ansicht Aufrufstapel der &gdb;-Erweiterung.

Die Ansicht Lokale Variablen enthält eine Liste aller zurzeit geladenen Variablen des Programms und die Werte dieser Variablen.

Die Ansicht „Lokale Variablen“ der &gdb;-Erweiterung Die Ansicht „Lokale Variablen“ der &gdb;-Erweiterung.

Die Ansicht Lokale Variablen der &gdb;-Erweiterung.

### Danksagungen

Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Martin Gergov, der den Hauptteil diese Abschnitts geschrieben hat.

## Modul „Header öffnen“

### Das Modul „Header öffnen“ benutzen

Bei der Bearbeitung von C- oder C++-Quelltext, wechseln Sie mit diesem Befehl zwischen der Header-Datei und dem zugehörigen C-/C++-Quelltextdatei und umgekehrt.

Wenn Sie zum Beispiel die Datei `myclass.cpp` bearbeiten, wechseln Sie mit dieser Aktionen zur Datei `myclass.h`, wenn Sie im selben Ordner vorhanden ist.

Paare der folgenden Erweiterungen für Dateinamen funktionieren:

- Header-Dateien: h, H, hh, hpp
- Quelltextdateien: c, cpp, cc, cp, cxx

### Menüstruktur

F12 Datei Quellen-/Headerdatei (.h/.cpp/.c) öffnen

- Öffnet die zugehörigen Header- oder Quelltextdateien für das aktive Dokument.

## Projektmodul

### Einleitung

Im Projekt-Modul wird eine strukturierte Liste von Dateien, die zu einem Projekt gehören, mit folgenden Eigenschaften angezeigt:

1. Eine strukturierte Ansicht der Dateien

2. Einfaches Öffnen und Wechseln zwischen Projekten

3. Suchen und Ersetzen in einem Projekt

4. Einfache Autovervollständigung

5. Dateien im Projekt schnell öffnen

6. Unterstützung für das Erstellen des Projekts

### Strukturierte Ansicht der Dateien

Ist das Projekt-Modul auf der Einrichtungsseite von &kate; aktiviert, können Sie eine Datei in einem Projekt öffnen. Dann wird eine Seitenleiste mit allen Projekten und deren Dateien wie folgt angezeigt:

Projektansicht

Das derzeit aktuelle Projekt ist Kate, der Inhalt wird in der Baumansicht angezeigt. Klicken Sie auf Dateien in der Baumansicht, um sie im Editor zu öffnen. Zusätzlich gibt es ein Kontextmenü, mit dem Sie Dateien mit anderen Programmen wie zum Beispiel `.ui`-Dateien mit dem Qt Designer öffnen können.

Sie können die Einträge filtern, indem Sie Teile des gesuchten Dateinamens in das Suchfeld unter der Liste eingeben.

### Projekte wechseln

Mit diesem Modul müssen Sie ein Projekt nie manuell öffnen, das ist auch nicht möglich. Wenn Sie eine Datei öffnen, durchsucht das Projekt-Modul schnell den Ordner und seine übergeordneten Ordner nach einer Datei mit dem Namen `.kateproject`. Wird diese Datei gefunden, wird das Projekt automatisch geladen.

Wenn Sie ein Dokument in &kate; öffnen, das zu einem anderen Projekt gehört, wechselt das Projekt-Modul automatisch zu diesem Projekt, Also ist immer das richtige Projekt aktiv. Natürlich können Sie auch mit dem Kombinationsfeld das aktuell aktive Projekt wechseln.

### Suchen und Ersetzen in Projekten

In &kate; gibt es ein Modul „Suchen und Ersetzen“, das in der Statusleiste unten angezeigt wird. Haben Sie ein Projekt geladen, öffnen Sie „Suchen und Ersetzen“ und wählen einen Modus für das aktuelle Projekt aus:

Suchen in Projekten

### Einfache Autovervollständigung

Das Projekt-Modul kann aus allen zu einem Projekt gehörenden Dateien eine einfache automatische Vervollständigung auf der Grundlage von CTags bereit stellen. Wird ein Projekt zum ersten mal geöffnet, Liest CTags alle Projektdateien im Hintergrund ein und speichert die CTags-Informationen in einer Datei im Ordner `/tmp`. Diese Datei wird dann verwendet, um die Vorschläge für die automatische Vervollständigung zu anzuzeigen.

Im Gegensatz dazu kann &kate; ohne CTags nur eine automatische Vervollständigung aus den Wörtern in der aktuellen Datei vorschlagen. Die Vervollständigung im Projekt-Modul ist viel leistungsfähiger.

Vervollständigung in Projekten

Ist CTags nicht installiert oder aktiviert, erhalten Sie einen Hinweis über diese Problem. Die CTags-Datei im Ordner `/tmp` wird automatisch beim Beenden von &kate; gelöscht, um unnötige Dateien loszuwerden.

### Schnellöffnen von Dateien

Da das Anklicken von Dateien in der Baumansicht nicht der schnellste Weg ist, um eine Datei zu öffnen, bietet &kate; einen eingebauten Mechanismus zum schnellen Öffnen, den Sie mit &Ctrl;&Alt;O aktivieren können. Dann wird die folgende Liste angezeigt:

Schnellöffner

Sie können die Einträge filtern, indem Sie Teile des gesuchten Dateinamens eingeben. Außerdem können Sie mit den Pfeiltasten navigieren und durch die Liste nach oben oder unten blättern. Durch Drücken von &Enter; wird die ausgewählte Datei aktiviert, während &Esc; das Fenster wieder ausblendet.

Das Modul merkt sich die vorher geöffnete Datei. Wechseln Sie also zu Schnellöffner-Ansicht, wird die vorher aktive Datei automatisch ausgewählt, so dass Sie nur noch die &Enter;taste zum Öffnen drücken müssen.

### Unterstützung für das Erstellen des Projekts

Außerdem wird das Erstellen-Modul unterstützt, so dass es automatisch richtig eingerichtet ist.

### Projekte erstellen

#### Projekte automatisch laden

Mit dem Projekt-Modul könne Dateien automatisch geladen werden, die Liste der Dateien wird aus dem Versionsverwaltungssystem gelesen. Dazu muss das automatische Laden für das entsprechende Versionsverwaltungssystem in den Einstellungen aktiviert werden. Dies ist die Voreinstellung.

Einstellungen für das Projektmodul

#### Projekte manuell erstellen

Sie müssen nur eine Datei `.kateproject` im Basisordner des Projekts zu erstellen. Die ist zum Beispiel der Inhalt der Datei `.kateproject` im Projekt Kate:

    {
      "name": "Kate"
    , "files": [ { "git": 1 } ]
    }

Der Inhalt der Datei ist in JSON-Syntax geschrieben. Kate ist der Name des Projekts und die Dateien darin werden aus einem „git“-Archiv gelesen.

Neben `git` werden auch Subversion (`svn`) und Mercurial (`hg`) unterstützt. Möchten sie die Dateien nicht aus einem Versionsverwaltungssystem lesen, können Sie auf folgende Weise angeben, welche Dateien rekursiv aus Ordnern gelesen werden sollen:

    {
      "name": "Kate"
    , "files": [ { "directory": "kate", "filters": ["*.cpp", "*.h", "*.ui", "CMakeLists.txt", "Find*.cmake"], "recursive": 1 } ]
    }

In dieser Datei definieren Unterordner und Filter die Teile des Projekts. Sie können auch Versionsverwaltungssysteme und und durch Filter definierte Dateien mischen.

Wenn Sie Unterstützung für das Erstellen-Modul hinzufügen möchten, können Sie folgende Datei `.kateproject` verwenden:

    {
      "name": "Kate"
    , "files": [ { "git": 1 } ]
    , "build": {
        "directory": "build"
      , "build": "make all"
      , "clean": "make clean"
      , "install": "make install"
      }
    }

### Aktuelles Projekt

Mit &Alt;1 Projekte Gehe zu können Sie die Ansicht Aktuelles Projekt unten im Editorfenster mit vier Karteikarten öffnen:

Aktuelles Projekt

Terminal

- Ein Terminalemulator im Basisordner des Projekts.

Quelltext-Index

- Mit der Eingabe von Zeichen in die Suchleiste wird die Suche gestartet und passende Namen von Funktionen, Klassen, Symbolen &etc; zusammen mit Typ, Dateinamen und Zeilennummer angezeigt.

  Wählen Sie ein Element in der Liste, um zu der zugehörigen Zeile in der Quelltextdatei zu springen.

Quelltext-Analyse

- Klicken Sie auf Analyse starten, um eine statische Quelltext-Analyse für die Sprachen C und C++ mit dem Programm `cppcheck` auszuführen und einen Bericht zu generieren. In den Bericht werden Dateiname, Zeilennummer, Schweregrad (Stil, Warnung &etc;) und das gefundene Problem eingefügt.

  Wählen Sie ein Element in der Liste, um zu der zugehörigen Zeile in der Quelltextdatei zu springen.

Notizen

- Der auf dieser Karteikarte eingegebene Text wird in der Datei ``Projektname`.kateproject.notes` gespeichert.

### Das Menü Projekte

Das Menü Projekte ermöglicht das Umschalten zwischen aktuell offenen Projekten. Es wird durch das Projektmodul angezeigt.

&Ctrl;&Alt;&Left; Projekte Zurück

- Wechselt zum vorherigen Projekt.

&Ctrl;&Alt;&Right; Projekte Nach vorn

- Wechselt zum nächsten Projekt.

&Alt;1 Projekte Gehe zu

- Öffnet die Ansicht Aktuelles Projekt unten im Editorfenster.

## Modul LSP-CLient

Das Modul LSP-Client bietet viele Sprachenfunktionen wie Quelltextvervollständigung, Navigation im Quelltext und Suche nach Referenzen auf der Basis des Language Server Protocol.

Wenn Sie den Eintrag LSP-Client auf der Modulseite aktiviert haben, wird eine neue Seite mit dem Namen LSP-Client im Einrichtungsdialog von &kate; angezeigt.

## Suchen und Ersetzen

### Einleitung

Mit &kate;'s Erweiterung „Suchen & Ersetzen“ können Sie nach einfachem Text oder regulären Ausdrücken in mehreren Dateien auf einmal suchen. Sie können alle geöffneten Dateien, alle Dateien in einem Ordner und je nach Einstellung auch in den Unterordnern oder im aktiven Dokument suchen. Auch das Filtern nach Dateinamen ist möglich, um zum Beispiel nur in Dateien mit einer bestimmten Erweiterung zu suchen.

### Oberfläche

#### Such-Anfrage

Die folgenden Einstellungen werden immer oben in der Ansicht „In Dateien suchen“ angezeigt.

- Sie können beliebig viele Suchvorgänge auf einmal öffnen. Klicken Sie dazu auf den Knopf Neues Unterfenster oben links in der Ansicht In Dateien suchen, dann können Sie eine weitere Suche starten.

- Mit dem Knopf rechts oben in der Ansicht „In Dateien suchen“ schalten Sie den unteren Anzeigebereich zwischen den zusätzlichen Einstellungen für die Suche und der Anzeige der Ergebnisse Ihrer Suche um.

Suchen

- In das Eingabefeld oben tragen Sie Text ein, den Sie suchen möchten. Sie können entweder einfachen Text oder einen regulären Ausdruck eingeben, wenn diese Einstellung aktiviert wurde.

Ersetzen (Textfeld)

- Text, der anstelle des Textes im Eingabefeld Suchen in die geöffneten Dokumente eingefügt wird.

Suchen

- Haben Sie alle Einstellungen richtig vorgenommen, dann drücken Sie zum Start auf den Knopf Suchen. Sie können auch die Taste &Enter; im Eingabefeld drücken, um eine Suche zu starten.

Ersetzen

- Haben Sie alle Einstellungen richtig vorgenommen, dann drücken Sie zum Start auf den Knopf Ersetzen, um den Text im Eingabefeld Suchen mit dem Text im Eingabefeld Ersetzen zu ersetzen. Sie können auch die Taste &Enter; im Eingabefeld Ersetzen drücken.

Weiter

- Geht zur nächsten Fundstelle der Suche. Wenn nötig, wird zum nächsten Dokument umgeschaltet.

Markierte ersetzen

- Macht dasselbe wie Ersetzen, aber nur in den Dokumenten, die unten markiert sind.

#### Einstellungen für die Suche in Ordnern

Diese Einstellungen erscheinen unter den vorher genannten Einstellungen für die Abfrage. Werden stattdessen die Ergebnisse einer Suche angezeigt, wechseln Sie mit zur Anzeige der zusätzlichen Einstellungen.

Suchen in

- In diesem Auswahlfeld gibt es drei Einstellungen. Wählen Sie In geöffneten Dateien, um in allen gerade in &kate; geöffneten Dateien oder In Ordner, um in einem Ordner und dessen Unterordnern zu suchen. Wählen Sie In der aktuellen Datei, um nur in dieser Datei zu suchen.

  Wenn das Modul Projekte geladen ist, können Sie auch im Aktuellen Projekt oder in Allen geöffneten Projekten suchen.

Groß-/Kleinschreibung beachten

- Beschränkt Sie die Suche auf Ausdrücke, die mit der gleichen Groß- und Kleinschreibung wie im Suchfeld auch in den Dateien vorhanden sind.

Reguläre Ausdrücke

- Erlaubt die Verwendung eines Regulären Ausdrucks anstatt eines einfachen Textes für die Suche.

Ergebnisse erweitern

- Zeigt alle Suchergebnisse in jedem Dokument an, nicht nur eine Liste der Dokumente, in denen die Suche erfolgreich war.

Ordner

- Hier können Sie den Ordner eingeben, in dem die Suche starten soll. Sie können zum Beispiel `~/development/kde/kate/`, eingeben, wenn Sie im Quelltext von &kate; suchen möchten. Diese Option steht nur dann zur Verfügung, wenn der Modus in Ordner benutzt wird.

Dateiauswahl-Dialog

- Drücken Sie diesen Knopf, um den Ordner im Dateiauswahldialog zu öffnen. Diese Option steht nur dann zur Verfügung, wenn der Modus Ordner benutzt wird.

- Drücken Sie diesen Knopf, um in den übergeordneten Ordner des aktuellen Ordners zu wechseln. Diese Option steht nur dann zur Verfügung, wenn der Modus Ordner benutzt wird.

- Mit diesem Knopf setzen Sie den Eintrag für den Ordner auf den Ordner, in der die gerade geöffnete Datei gespeichert ist. Diese Option steht nur dann zur Verfügung, wenn der Modus Ordner benutzt wird.

Filter

- Mit dem Filter können Sie nur nach Dateien mit einem bestimmten Namensmuster suchen. Um zum Beispiel nur nach C++-Dateien zu suchen, geben Sie `*.cpp`. Alle Dateien, deren Namen mit `kate` beginnt, finden Sie mit der Eingabe `kate*`. Sie können mehrere Filter getrennt durch Komma (`,`) eingeben. Diese Option steht nicht zur Verfügung, wenn der Modus Offene Dateien benutzt wird.

Ausschließen

- Diese Option ermöglicht, Dateien von der Suche auszuschließen. Wie im Filter können Sie mehrere Namensmuster, durch ein Komma getrennt, eingeben (`,`). Diese Option steht nicht zur Verfügung, wenn der Modus Offene Dateien benutzt wird.

Rekursiv

- Ist diese Einstellung aktiviert, sucht &kate; auch in allen Unterordnern des ausgewählten Ordners. Diese Option ist nur verfügbar, wenn der Modus Ordner benutzt wird.

Versteckte Dateien einbeziehen

- Ist diese Einstellung aktiviert, sucht &kate; auch in Dateien und Ordner, die normalerweise durch das &OS; versteckt werden. Diese Option steht nur zur Verfügung, wenn der Modus Ordner benutzt wird.

Symbolischen Verknüpfungen folgen

- Normalerweise durchsucht diese Erweiterung keine symbolischen Verknüpfungen. Ist diese Einstellung aktiv, folgt die Erweiterung bei der Suche stattdessen symbolischen Verknüpfungen und sucht in Ordnern oder Dateien, auf die sie verweisen. Diese Option steht nur zur Verfügung, wenn der Modus Ordner benutzt wird.

  Eine symbolische Verknüpfung verweist möglicherweise auf einen Ordner, der der übergeordnete Ordner des gerade durchsuchten Ordners ist, oder andere Ordner, die symbolische Verknüpfungen zu übergeordneten Ordnern enthalten. Gibt es in einem der durchsuchten Ordner eine derartige Verknüpfung, dann folgt &kate; bei aktivierter Einstellung diesen Verknüpfungen und durchsucht die Ordner. Dann wird die Suche niemals abgeschlossen.

Einschließlich Binärdateien

- Ist diese Einstellung aktiviert, sucht &kate; auch in Dateien, die keine Textdateien zu sein scheinen.

#### Suchergebnisse

Die Ergebnisse Ihrer Suche werden unterhalb der Einstellungen zur Abfrage angezeigt. Werden die Einstellungen zum Suchmodus In Ordner angezeigt, drücken Sie auf das Symbol , um die Suchergebnisse anzuzeigen. Diese Ergebnisse werden auch automatisch angezeigt, wenn die Suche beendet ist.

Das Suchergebnis ist eine Liste der Dateien, die Text enthalten, der gesucht wurde. Zu jeder Datei wird die Anzahl der Fundstellen angegeben.

Wenn Sie eine Liste der Fundstellen in der Datei sehen wollen, klicken Sie einfach auf den Pfeil links vom Dateinamen. Wenn Sie die Option Ergebnisse erweitern eingeschaltet hatten, wird die Liste sofort ausführlich angezeigt. Die Zeilennummer jeder Fundstelle wird angezeigt, danach sehen Sie den Inhalt der Zeile mit dem Suchtext hervorgehoben.

Um eine Datei mit gefundenen Treffern der Suche zu öffnen, klicken Sie zweimal drauf. &kate; öffnet die Datei, falls erforderlich, und setzt den Cursor an den Anfang des gefundenen Suchtexts. Sie können auch sofort an eine bestimmte Fundstelle springen, indem Sie auf diese Fundstelle in der Liste doppelklicken.

### Menüstruktur

&Ctrl;&Alt;F Bearbeiten In Dateien suchen

- Öffnet das Werkzeug Suchen und Ersetzen

Bearbeiten Zum nächsten Treffer springen

- Springt zur nächsten Fundstelle.

Bearbeiten Zum vorherigen Treffer springen ...

- Springt zur vorherigen Fundstelle.

Ansicht Werkzeugansichten Suchen und Ersetzen anzeigen

- Schaltet die Anzeige des Werkzeugs Suchen und Ersetzen ein und aus

## Kate-Textbausteine

### Einleitung

Kate-Textbausteine ist eine Erweiterung, mit dem Sie sogenannte Bausteine (wiederverwendbarer Quelltext oder beliebiger Text) benutzen und sich damit die Eingabe von Text erleichtern können. Die Erweiterung unterstützt außerdem Quelltextvervollständigung und JavaScript.

### Menüstruktur

Ansicht Werkzeugansichten Textbausteine anzeigen

- Zeigt die Textbaustein-Seitenleiste mit allen Bausteinen aus Ihrem Archiv für den gerade geöffnete Dateityp.

Extras Textbaustein erstellen

- Erstellt einen neuen Textbaustein, der als wieder verwendbarer Text in jeden Bereich von beliebigen Dokumenten eingefügt werden kann.

### Textbaustein-Seitenleiste

Textbaustein-Seitenleiste für Kate Die Textbaustein-Seitenleiste für &kate;.

Die Seitenleiste für &kate;-Textbausteine.

In der Seitenleiste wird eine Liste der Textbaustein-Archive angezeigt. Außerdem können Sie eigene Archive erstellen, aus dem Internet oder von lokalen Dateien laden. Jedes Archiv hat ein Ankreuzfeld, um es zu aktivieren oder zu deaktivieren. Mit den Knöpfen unter der Archivliste können Sie vorhandene Archive bearbeiten oder löschen.

#### Textbaustein-Archivdateien laden

Sie können Textbaustein-Archive aus dem Internet herunterladen. Drücken Sie dazu auf Neue Textbausteine herunterladen, um eine Liste aller verfügbaren Archive anzuzeigen. Nachdem Sie das gewünschte Archiv heruntergeladen haben, müssen Sie es noch aktivieren.

#### Textbausteinarchive erstellen und bearbeiten

Um ein neues Textbausteinarchiv anzulegen, drücken Sie auf Archiv hinzufügen. Geben Sie im nächsten Dialog dann den Namen der Textbausteindatei und die Autoren ein und wählen eine Lizenz. Nach Eingabe aller Daten drücken Sie auf OK.

Textbaustein-Editor Der Archiv-Editor.

Die Benutzerschnittstelle des Archiv-Editors.

Der Editor für Textbausteinarchive enthält die folgenden Einstellmöglichkeiten:

Name

- Erscheint in der Liste der Textbausteine in der Werkzeugansicht und danach wird außerdem bei der Benutzung der Quelltextvervollständigung gesucht.

Namensraum

- Präfix, das für die Quelltextvervollständigung verwendet wird.

Lizenz

- Wählen Sie die Lizenz für Ihr Textbausteinarchiv.

Autoren

- Geben Sie hier den Namen der Autoren der Textbausteindatei ein.

Dateitypen

- Wählen Sie einen oder mehrere Dateitypen für dieses Textbaustein-Archiv. Als Voreinstellung wird hier verwendet, dann wird das Archiv für alle Dateitypen benutzt. Sie können den Typ zum Beispiel auf `C++` ändern oder aus einer Liste von Dateitypen auswählen, Benutzen Sie die &Shift;-taste, um mehrere Dateitypen hinzuzufügen.

#### Textbausteine erstellen und bearbeiten

Textbaustein-Editor Der Textbaustein-Editor.

Die Benutzerschnittstelle des Textbaustein-Editors.

Name

- Der Name wird in der Vervollständigungsliste angezeigt.

Kurzbefehl

- Drücken Sie diesen Kurzbefehl, um den Textbaustein in das Dokument einzufügen.

Textbausteine

- Der Text, der mit Ihrem Textbaustein in das Dokument eingefügt wird.

  Ein Textbaustein kann editierbare Felder enthalten. Zwischen diesen Feldern können Sie mit der taste wechseln. Folgende Ausdrücke können in Vorlagentexten benutzt werden, um Felder zu erstellen:

  Mit `${`field_name`}` erstellen Sie ein einfaches Feld, dessen Wert editiert werden kann. Alle weiteren Vorkommen desgleichen `field_name` sind Felder, die den Wert des ersten Felds beim Editieren erhalten.

  Mit `${`field_name=default`}` können Sie einen Standardwert für ein Feld angeben. Als Standardwert `default` kann ein beliebiger JavaScript-Ausdruck verwendet werden.

  Mit `${`field_name`=`text`}` können Sie einen Text als Vorgabewert angeben.

  Mit `${func(`other_field1`, `other_field2`, ...)}` können Sie ein Feld erstellen, das eine JavaScript-Funktion bei jeder Bearbeitung evaluiert und den Wert des Felds enthält. Auf der Karteikarte Skripte finden Sie weitere Informationen.

  Mit `${cursor}` können Sie die Endposition des Cursors angeben, nachdem alle Felder ausgefüllt wurden.

Skripte

- JavaScript-Hilfsfunktionen, die Sie in Ihren Textbausteinen verwenden können.

  Alle JavaScript-Funktionen sollten den Inhalt für ein Vorlagenfeld als Zeichenkette zurückgeben.

  Funktionen werden in einem Gültigkeitsbereich aufgerufen, der den Inhalt aller editierbaren Vorlagenfelder als lokale Variablen enthält. Gibt es zum Beispiel in einem Textbaustein `${`Feld`}`, dann gibt es eine Variable mit dem Namen `field`, die den aktuellen Wert des Vorlagenfelds enthält.Diese Variablen können entweder statisch in der Funktion verwendet oder als Argument übergeben werden, indem Sie `.${func(field)}` oder `${`field2=func(field)`}` in der Zeichenkette des Textbausteins verwenden.

  Mit der Programmierschnittstelle (Skript-API) von &kate; haben Sie Zugriff auf ausgewählten Text, den gesamten Text, den Dateinamen und weitere Informationen mit den zugehörigen Methoden der Objekte `document` und `view`. Weitere Informationen finden Sie in der Programmierschnittstelle von &kate;.

### Textbausteine benutzen

Kate-Textbausteine in Aktion Zugriff auf &kate;-Textbausteine in der Werkzeugansicht und im Auswahlfeld.

Auswahl aus einer Liste von Textbausteinen.

Sie können Textbausteine auf zwei Arten aufrufen:

- Wählen Sie einen Textbaustein aus der Werkzeugansicht.

- Drücken Sie beim Schreiben die Tastenkombination &Ctrl; Leerzeichen, dann wird eine Liste aller Textbausteine in einem Auswahlfeld angezeigt. Dann erscheinen ähnlich wie bei der Quelltextvervollständigung nur die passenden Textbausteine im Auswahlfeld.

Wenn der Textbaustein zudem die Variable `${cursor}` enthält, geht der Cursor automatisch zur ersten Postion der Variablen und erlaubt Ihnen dann, hier einen Text einzugeben. Nach der Eingabe drücken Sie die -taste, um zur nächsten Variablen zu springen usw.

### Danksagungen

Die &kate;-Textbausteine wurden von Joseph Wenninger geschrieben.

Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Martin Gergov, der den Hauptteil diese Abschnitts geschrieben hat.

## SQL-Modul

### Einleitung

Die Datenbanksprache SQL (Structured Query Language) ist eine spezialisierte Sprache zur Aktualisierung, Löschung und Abfrage von Informationen von Datenbanken.

Mit dem SQL-Modul von &kate; können Sie:

- Eine Datenbank erstellen

- Eine Verbindung zu einer vorhandenen Datenbank erstellen

- Daten in eine Datenbank einfügen und löschen

- Abfragen ausführen

- Ergebnisse in einer Tabelle anzeigen

### Verbindung zu einer Datenbank

Wählen Sie Verbindung hinzufügen aus dem Menü SQL oder der Werkzeugleiste und dann einen Qt-Datenbanktreiber (QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7, und QPSQL). Fehlt ein gewünschter Treiber, dann müssen Sie ihn installieren. Drücken Sie dann den Knopf Weiter.

Wenn die ausgewählte Datenbank eine Datei verwendet, geben Sie nur den Ordner der Datenbank an und drücken dann den Knopf Weiter. Zur Verbindung zu einer Datenbank auf einem Server, müssen Sie den Rechnernamen des Servers, Ihren Benutzernamen, das Passwort und alle sonstigen erforderlichen Informationen für den ausgewählten Treiber angeben. Drücken Sie dann den Knopf Weiter.

Zum Abschluß geben Sie einen eindeutigen Namen für die Verbindung an und drücken auf Fertigstellen.

### Abfragen ausführen

#### INSERT/DELETE/UPDATE

Mit dem SQL-Modul können Sie genau wie von der Befehlszeile oder aus einem Programm Daten einfügen. löschen oder aktualisieren. Geben Sie die Abfrage ein und drücken Sie den Knopf Abfrage ausführen in der Werkzeugleiste oder benutzen Sie aus dem Menü SQL Abfrage ausführen (&Ctrl;E).

##### Einige Beispiel-Abfragen

`INSERT`

-     INSERT INTO table_name ("feature1", "feature2", "feature3", "feature4", "feature5")
      VALUES ("value1", "value2", "value3", "value4", "value5" )

`DELETE`

-     DELETE FROM table_name WHERE name = "text"

`UPDATE`

-     UPDATE table_name SET "feature1" = "text", "feature2" = "text", "feature3" = "text", "feature4" = "text", "feature5" = "text"

#### SELECT

Nach der Ausführung einer `SELECT`-Abfrage wird das Ergebnis als Tabelle in der Ansicht SQL-Datenausgabe oder als Text in der SQL-Textausgabe unten im Fenster von &kate; angezeigt. Fehlermeldungen erscheinen ebenfalls in der Textausgabe.

##### Beispiel einer `SELECT`-Abfrage

    SELECT * FROM table_name

In der Ansicht SQL-Datenausgabe gibt es mehrere Knöpfe:

Spaltengröße an Inhalte anpassen

- Ändert die Größe der Spalten, so dass der Inhalt vollständig angezeigt wird.

Zeilengröße an Inhalte anpassen

- Ändert die Größe der Zeilen, so dass der Inhalt vollständig angezeigt wird.

Kopieren

- Wählt den gesamten Inhalt der Tabelle und kopiert ihn in die Zwischenablage.

Exportieren

- Exportiert die gesamte Tabelle in eine Datei, in die Zwischenablage oder das aktuelle Dokument als durch Komma getrennte Werte.

Zurücksetzen

- Löscht die gesamte Tabellenansicht.

Die in der Tabelle verwendeten Farben können Sie im Einrichtungsdialog auf der Seite SQL einstellen.

### Datenbank durchsuchen

Ihre Datenbank können Sie mit der Ansicht SQL-Schema-Browser links im Hauptfenster durchsuchen. Die darin angezeigten Informationen hängen vom verwendeten Datenbanktreiber ab.

Um die Liste zu aktualisieren, klicken Sie mit der &RMBn; irgendwo in die Ansicht und wählen Aktualisieren. Um eine Abfrage für einen Eintrag in der Liste auszuführen, klicken mit der &RMBn; darauf und wählen Erzeugen und die Art der Abfrage (SELECT, UPDATE, INSERT, und DELETE) aus dem Kontextmenü.

### Menüstruktur

SQL Verbindung hinzufügen ...

- Fügt eine neue Verbindung mit einem beliebigen Datenbanktreiber hinzu.

SQL Verbindung entfernen

- Entfernt die ausgewählte Verbindung.

SQL Verbindung bearbeiten ...

- Öffnet den Dialog Verbindungsassistent, in dem Sie die Einstellungen der Verbindung ändern können.

Verbindungen

- Alle von Ihnen erstellten Datenbankverbindungen werden im Menü SQL zwischen den Einträgen Verbindung bearbeiten und Abfrage ausführen angezeigt.

&Ctrl;E SQL Abfrage ausführen

- Startet Ihre SQL-Abfrage.

### Danksagungen

Das SQL-Modul wurde von Marco Mentasti geschrieben.

Besonderer Dank geht an den „Google Code-In 2011“-Teilnehmer Ömer Faruk ORUÇ, der den Hauptteil diese Abschnitts geschrieben hat.

## Symbolansicht-Modul

### Das Modul zum bedingten Schließen benutzen

Dies Modul zeigt Symbole wie Funktionen, Makros und Strukturen im Quelltext an.

Durch Klicken auf die eingelesenen Informationen können Sie direkt den Quelltext durchsehen.

Zur Zeit werden folgende Sprachen unterstützt:

C/C++, Java, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran

Funktionsliste:

- Listen-/Baummodus
- Sortierung ein- bzw. ausschalten
- Funktionsparameter anzeigen bzw. ausblenden
- Baumansicht ein- bzw. ausklappen
- Automatische Aktualisierung bei Änderungen des Dokuments
- Da Einlesen basiert auf der Bibliothek Syntax-Highlighting der &kde-frameworks;

### Menüstruktur

&Ctrl;\ Ansicht Werkzeugansichten Symbolliste anzeigen

- Schaltet die Symbolliste mit der Anzeige von Funktionen, Makros und Strukturen des Quelltexts im aktiven Dokument ein oder aus.

### Einstellungen

Symbolansicht

Auswahl der Standardeinstellungen zum Einlesen

## Werkzeugansicht für Terminal - Werkzeugansicht, die ein Terminal-Element einbettet

Der eingebaute Terminal-Emulator ist eine Kopie der &kde;-Anwendung &konsole;, er ist durch Wählen von Ansicht Werkzeugansichten Terminal anzeigen aufrufbar und bekommt beim Einschalten den Fokus. Wenn die Option Automatisch Terminal mit aktuellem Dokument abgleichen eingeschaltet ist, wird das Verzeichnis des Terminal-Emulators in das Herkunftsverzeichnis der aktuellen Datei umgeschaltet, wenn dies möglich ist.

Die Standardposition ist unten im &kate;-Fenster, unterhalb des Editorfensters.

Sie können die Einstellungen des Terminal-Emulators durch das mit der rechten Maustaste aufrufbare Kontextmenü erreichen, lesen Sie dazu das Handbuch zu &konsole; für weitere Informationen.

Der eingebaute Terminal-Emulator wird vom Terminal-Modul bereit gestellt.

### Menüstruktur

Ansicht Werkzeugansichten Terminal anzeigen

- Schaltet die Anzeige des eingebauten Terminal-Emulators ein und aus.

  Wenn dieser zum ersten Mal aktiviert wird, dann wird ein neuer Terminal-Emulator erzeugt.

  Wenn der Terminal-Emulator gestartet wird, erhält bekommt er den Fokus, damit Sie sofort mit dem Eingeben von Befehlen beginnen können. Wenn die Option Terminal-Ordner automatisch mit aktuellem Dokument abgleichen (wenn möglich) auf der Seite Terminal des Enrichtungsdialogs eingeschaltet ist, wird der Pfad des Terminal-Emulators auf den Pfad des aktiven Dokuments gesetzt, wenn es sich um ein lokales Dokument handelt.

Extras An Terminal weitergeben

- Gibt den aktuell markierten Text an den eingebauten Terminalemulator. An das Ende des Textes wird kein Zeilenendezeichen angehängt.

Extras Terminal mit aktuellem Dokument abgleichen

- Diese Option bewirkt, dass der eingebaute Terminal-Emulator mit `cd` zum Ordner des aktuellen Dokuments wechselt,

  Alternativ können Sie &kate; so einstellen, dass das Terminal immer in den Ordner des aktuellen Dokuments wechselt. Weitere Informationen finden Sie unter konsole-config.

Extras Terminal den Fokus geben/entziehen

- Schaltet den Fokus vom aktuellen Dokument zum Terminal und zurück.

### Einstellungen

Die Einstellungen für den Terminal-Emulator auf der Seite Terminal des Einstellungsdialoges vornehmen.

Die folgenden Einstellungen können ausgewählt werden:

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.

## Textfilter-Modul

### Das Textfilter-Modul benutzen

Mit diesem Modul können Sie ausgewählten Text mit Shell-Befehle bearbeiten. Als Argument für den Befehl wird eine Textauswahl verwendet. Die Ausgabe des Befehls ersetzt entweder die Auswahl oder wird in die Zwischenablage kopiert, abhängig von den Benutzereinstellungen.

### Beispiele:

- `less /etc/fstab` - Fügt den Inhalt dieser Datei in das Dokument ein oder kopiert es in die Zwischenablage

- `wc` - Zählt Zeilen, Wörter und Zeichen in der Auswahl und fügt dies ins Dokument ein oder kopiert es in die Zwischenablage

- `sort` - Sortiert die Zeilen in der Auswahl und fügt das Ergebnis ins Dokument ein oder kopiert es in die Zwischenablage

### Menüstruktur

&Ctrl;\ Extras Text filtern

- Öffnet den Textfilter-Dialog:

  Textfilter-Dialog

  Geben Sie den Shell-Befehl im Kombinationsfeld ein oder wählen Sie einen Befahl aus dem Verlauf.

  Kopiert das Ergebnis anstatt es einzufügen

- Kopiert das Ergebnis in die Zwischenablage und lässt das Dokument unverändert.

STDOUT und STDERR zusammenführen

- Ist dies aktiviert, werden die Ausgaben von STDOUT und STDERR zusammengeführt und keine Fehler gemeldet. Ansonsten wird die Ausgabe auf STDERR in einem passiven Nachrichtenfenster angezeigt.

## &XML;-Überprüfung

Diese Erweiterung überprüft &XML;-Dateien auf richtige Form und Gültigkeit.

Diese Erweiterung überprüft die aktuelle Datei. Eine Liste mit Warnungen und Fehlern erscheint im unteren Teil des Hauptfensters von &kate;. Wenn Sie auf eine Fehlermeldung klicken, gelangen Sie zu der entsprechenden Stelle in der Datei. Besitzt die Datei einen DOCTYPE, wird die darin angegebene DTD für die Überprüfung der Korrektheit der Datei benutzt. Die DTD muss sich an einem zur aktuellen Datei relativen Ort befinden. Wenn ⪚ der Doctype auf DTD/xhtml1-transitional.dtd verweist und die aktuelle Datei `/home/peter/test.xml` ist, muss sich die DTD in `/home/peter/DTD/xhtml1-transitional.dtd` befinden. Es werden auch entfernte DTDs über http unterstützt.

Dateien, die keinen Doctype besitzen, werden auf richtige Form hin überprüft.

Wenn Sie mehr über &XML; lernen möchten, besuchen Sie die offiziellen W3C &XML; Seiten.

Intern ruft die Erweiterung den externen Befehl `xmllint` auf, der Teil von libxml2 ist. Wenn dieser Befehl nicht korrekt auf Ihrem System installiert ist, funktioniert die Erweiterung nicht.

Um diese Erweiterung zu laden, öffnen Sie den Einrichtungsdialog von &kate; mit Einstellungen &kate; einrichten .... Wählen Sie dann &XML;-Überprüfung im Abschnitt Programm / Erweiterungen und schließen den Dialog.

### Menüstruktur

&XML; &XML; überprüfen

- Dies startet die Überprüfung wie oben beschrieben.

### Danksagungen

&kate;-Erweiterung &XML;-Überprüfung Copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;.

Copyright der Dokumentation 2002 &Daniel.Naber;

## &XML;-Vervollständigung

Diese Erweiterung gibt Hinweise, was an einer bestimmten Stelle einer &XML;-Datei gemäß der zugehörigen DTD erlaubt ist. Es zeigt, abhängig von der Cursor-Position, mögliche Elemente, Attribute, Attributwerte oder Entitäten an (⪚ werden alle Entitäten angezeigt, wenn das Zeichen links vom Cursor & ist). Es ist außerdem möglich, die nächste linksseitige nicht-geschlossene Marke zu schließen.

Die DTD muss im &XML;-Format vorliegen, wie es das Perl-Programm `dtdparse` liefert. Eine DTD mit diesem Format wird als Meta-DTD bezeichnet. Einige Meta-DTDs werden mitgeliefert. Sie befinden sich im Ordner `katexmltools/` in ``qtpaths` `--paths GenericDataLocation`` , der auch der Standardordner für den Menü-Befehl Meta-DTD zuweisen ... ist. Um eigene Meta-DTDs zu erzeugen, benötigen Sie `dtdparse` von http://dtdparse.sourceforge.net.

### Anwendung

Starten Sie &kate; und öffnen Sie den Einrichtungsdialog mit Einstellungen &kate; einrichten .... Dann wählen Sie &XML;-Vervollständigung im Abschnitt Programm Erweiterungen. Danach wählen Sie &XML;Meta-DTD zuweisen .... Wenn Ihr Dokument keinen DOCTYPE enthält oder dieser unbekannt ist, wählen Sie eine Meta-DTD aus Ihrem Dateisystem. Ansonsten wird die passende Meta-DTD für Ihr aktuelles Dokument automatisch geladen.

Jetzt können Sie die Erweiterung während der Texteingabe benutzen.

< (kleiner als)

- Damit wird eine Liste mit möglichen Elementen angezeigt, solange sich der Cursor nicht schon in einer Marke befindet. Beachten Sie, dass Sie dies derzeitig noch nicht benutzen können, um ein Element aus der obersten Ebene einzufügen (⪚ <html>).

</(Zeichen "kleiner als" und Schrägstrich)

- Die Eingabe dieser Zeichen schlägt das Schließen des aktuellen Elements vor (das nächste offene links vom Cursor). Drücken Sie die &Enter;-Taste, um den Vorschlag zu akzeptieren. Anders als der Menüpunkt Element schließen, funktioniert dies nur mit einer zugewiesenen DTD.

" (Anführungszeichen)

- Die Eingabe des Anführungszeichens innerhalb einer Marke wird eine Liste mit möglichen Attributwerten anzeigen, wenn es welche gibt.

(Leertaste)

- Diese Taste wird eine Liste mit möglichen Attributen für das aktuelle Element anzeigen, wenn die Taste innerhalb einer Marke gedrückt wird.

& (Kaufmanns-Und)

- Diese Taste wird eine Liste mit definierten Entitäten anzeigen.

### Funktionen und Einschränkungen

Sie können alle Funktionen und Einschränkungen testen, indem Sie die Datei `katexmltools/testcases.xml` in ``qtpaths` `--paths GenericDataLocation`` in &kate; laden und den Anweisungen folgen.

### Menüstruktur

&Ctrl;&Enter; &XML; Element einfügen ...

- Damit öffnen Sie einen Dialog zum Einfügen eines &XML;-Elementes. Die <,>-Zeichen und die schließende Marke werden automatisch eingefügt. Wenn vorher Text markiert war, wird dieser mit einer öffnenden und einer schließenden Marke umgeben. Mit dem Dialog ist es auch möglich, alle an der Cursor-Position eingegebenen Elemente zu vervollständigen, wenn eine Meta-DTD mittels Meta-DTD zuweisen ... zugewiesen wurde.

&Ctrl;< &XML; Element schließen

- Sucht im Text nach einer Marke, die noch nicht geschlossen wurde und schließt diese durch Einfügen der entsprechenden schließenden Marke. Die Suche erfolgt von der Cursor-Position aus nach links. Falls keine offene Marke gefunden wird, hat dieser Befehl keine Auswirkungen.

&XML; Meta-DTD zuweisen ...

- Bestimmt die Meta-DTD für das aktuelle Dokument. Beachten Sie, dass diese Zuordnung nicht gespeichert wird. Sie muss beim nächsten Programmstart von &kate; wiederholt werden.

### Danksagungen

&kate;-Erweiterung XML-Vervollständigung Copyright 2001, 2002 &Daniel.Naber; &Daniel.Naber.mail;.

KDE SC 4 Version Copyright 2010 Tomáš Trnka

Copyright der Dokumentation 2001, 2002 &Daniel.Naber;